Contact Model

Contacts are your site visitors who interact with Drift. Contacts may provide you with their email address, or their information may have been updated in the past 90 days. Contacts belong to an account, and may have conversations, composed of messages, with your users.

Schema

{
  "attributes": {
    "email": "[email protected]",
    "events": {},
    "name": "Stephen Webel",
    "socialProfiles": {},
    "tags": [],
    "externalId": 12341243, //sometimes set by external integrations
    ...
  },
  "createdAt": 1506971031434,
  "id": 349999553
}

Top Level Field Explanation

The top-level contact object is intentionally simple, allowing for deep customization via attributes.

Field Name	Description	Description
id	long (int64)	The Drift identifier for the contact. This will always be numeric. Should be treated as long or integer 64 bit data type.
createdAt	long	A unix timestamp for when the contact was first captured.
attributes	JSON	A map of all attributes associated with this contact. Attributes will contain both Drift controlled data and custom attributes generated by an organization or a third-party app.

Contact Attributes Explanation

Attributes will contain a mix of Drift-generated data as well as custom attributes. Custom Attributes are easily added by simply adding a key and a non-null value to the attribute map when either creating or updating a contact.

Field	Type	Description
name	String	The name of the contact
email	String	The email of the contact
phone	String	The phone number associated with the contact
tags	List of ContactTags	A list of all tags associated with the contact
events	JSON	A map of Drift events associates with the contact.
socialProfiles	JSON	A map of social profile information enriched for the contact.

🚧
Note on Account/Contact Relationship
Because Drift works to deanonymize visitors through IP address, Contacts are related to Accounts through email and website domain. All Accounts have a unique ID composed of the Drift OrgId and the Account Domain. For example, if the OrgId is 5002142 and the Account has a domain of https://www.drift.com, the Account Id will be 5002142_drift.com. This makes Account Id guessable for Contacts in Drift on the basis of their email.

📘
Want to customize your data?
You aren't just limited to text and number fields. Find out about other data types here