Export Contacts (v3)
Bulk, incremental export of contacts, with the contacts deleted since the cursor in the same list. Rows are in the order to apply them, so the last row for an ID is that contact’s state.
Results are paginated with an opaque cursor returned as pagination.nextCursor. Pass it back as cursor to fetch the next page. A null cursor means you are caught up: keep the cursor you sent and send it again on the next sync. A cursor from Export Contacts is accepted, so a sync can move to this endpoint without starting over. Deletions are kept for about six months: a stored cursor whose deletions are more than 179 days old, or whose walk started more than 178 days before it read any, returns 400 cursor_expired, and you restart without a cursor.
Request access. This endpoint is not enabled by default, contact the Conversion team to request access. Calls from accounts without it return
403 export_not_enabled.
Authorizations
Body
The opaque pagination cursor returned as pagination.nextCursor by a previous call to this endpoint or to Export Contacts. Omit (or pass an empty string) on the first call to start from the beginning: every live contact, then every deleted contact Conversion still keeps. An invalid or malformed cursor returns an invalid_cursor error.
"c1.eyJjb250YWN0cyI6ImV5SmpjbVZoZEdWa1FYUWlPaUl5TURJMkxUQXhMVEUxVkRFd09qTXdPakF3V2lKOSIsImRlbGV0aW9ucyI6eyJ1cGRhdGVkQXQiOiIyMDI2LTA1LTMxVDEyOjAwOjAwWiIsInJlY29yZElkIjoiYjJjM2Q0ZTUtZjZhNy04OTAxLWJjZGUtZjIzNDU2Nzg5MDEyIn19"
The maximum number of live contacts per page. A page also carries up to this many (at most 1000) deleted or restored contacts. Defaults to 1000. Values are clamped to the range [1, 5000] rather than rejected; values above 5000 return 5000 results.
1 <= x <= 5000Was this page helpful?