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 |
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. |
Want to customize your data?
You aren't just limited to text and number fields. Find out about other data types here
Updated 3 months ago