curl --request POST \
  --url https://pub-api.conversion.ai/api/v2/exports/contacts \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "limit": 1000
}'

{
  "data": {
    "contacts": [
      {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "sfdcLeadId": "00Q5f000001AbCdEAE",
        "sfdcContactId": null,
        "sfdcAccountId": "0015f00000ACMExAAB",
        "email": "jane@example.com",
        "subscriptionStatus": "SUBSCRIBED",
        "createdAt": "2026-01-15T10:30:00Z",
        "updatedAt": "2026-06-01T08:15:00Z",
        "fields": {
          "first_name": "Jane",
          "owner_id": "0055f000000AbCdEFG"
        }
      }
    ]
  },
  "pagination": {
    "nextCursor": "eyJjcmVhdGVkQXQiOiIyMDI2LTA2LTAxVDA4OjE1OjAwWiJ9"
  }
}

Exports

Export Contacts

Bulk, incremental export of contacts, ordered by updatedAt ascending. Each contact’s fields are flattened under fields, keyed by their label.

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 there are no more results. Persist the last non-null cursor between syncs to resume. Passing the stored cursor on a later call yields contacts created or updated since.

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.

POST

exports

contacts

curl --request POST \
  --url https://pub-api.conversion.ai/api/v2/exports/contacts \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "limit": 1000
}'

{
  "data": {
    "contacts": [
      {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "sfdcLeadId": "00Q5f000001AbCdEAE",
        "sfdcContactId": null,
        "sfdcAccountId": "0015f00000ACMExAAB",
        "email": "jane@example.com",
        "subscriptionStatus": "SUBSCRIBED",
        "createdAt": "2026-01-15T10:30:00Z",
        "updatedAt": "2026-06-01T08:15:00Z",
        "fields": {
          "first_name": "Jane",
          "owner_id": "0055f000000AbCdEFG"
        }
      }
    ]
  },
  "pagination": {
    "nextCursor": "eyJjcmVhdGVkQXQiOiIyMDI2LTA2LTAxVDA4OjE1OjAwWiJ9"
  }
}

Authorizations

X-API-Key

string

header

required

Your Conversion API key. Found in Settings > Integrations in the dashboard. Format: sk_live_<key_id>_<secret>.

Body

application/json

cursor

string

The opaque pagination cursor returned as pagination.nextCursor by a previous call. Omit (or pass an empty string) on the first call to start from the beginning. An invalid or malformed cursor returns an invalid_cursor error.

Example:

"eyJjcmVhdGVkQXQiOiIyMDI2LTAxLTE1VDEwOjMwOjAwWiJ9"

limit

integer

default:1000

The maximum number of contacts to return per page. Defaults to 1000. Values are clamped to the range [1, 5000] rather than rejected; values above 5000 return 5000 results.

Required range: 1 <= x <= 5000

Response

A page of contacts retrieved successfully.

data

object

Show child attributes

pagination

object

Show child attributes

Batch Add Contacts to Campaign Export Email Events

⌘I