v1

latestSwagger 2.0Apache 2.02026-08-06303655.6 KB
contacts

Get contacts

Returns paginated contacts for the authenticated account. Optionally filter by list.

get/contacts

Query parameters

list_idinteger

Filter to contacts belonging to this list ID

skipinteger

Number of records to skip (default 0)

limitinteger

Maximum records to return (default 50, max 5000)

sortstring

Field to sort by: id, first_name, last_name, email, created, updated

sort_direction'asc' | 'desc'

Sort direction: asc or desc

systemstring

Filter by external system name (e.g. 'hubspot'). Can be combined with identifier and/or system_identifier.

identifierstring

Filter by the contact's ID in the external system.

system_identifierstring

Filter by external sub-system identifier (e.g. a HubSpot portal ID).

Response

Successful response