Get Contact

Fetch a single contact by email or cnvContactId. Provide exactly one identifier; cnvContactId takes precedence when both are provided.

When looking up by email, the most recently updated contact with that email address is returned.

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.

get/v2/contacts

Request

  • Base URL
    https://pub-api.conversion.ai/api
  • Auth
    • API key in header X-API-Key
    • or API key in query parameter api_key

Query parameters

emailstring email

The contact's email address. When multiple contacts share the same email, the most recently updated contact is returned.

cnvContactIdstring uuid

The Conversion contact ID.

Response

Contact retrieved successfully.

Example response

{
  "data": {
    "contact": {
      "fields": {
        "first_name": "Jane",
        "last_name": "Smith",
        "job_title": "VP of Marketing"
      }
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.