What it is
The Contacts dataset is one row per contact created in your space within the window. A contact is a person known to your tracker (internally called a profile).
- Grain: one row per contact (
id).
- Windowed on:
created_at (UTC timestamp) — the contact’s original creation time. The internal row timestamp is never exported.
- Path segment:
contacts.
Contacts are mutable. Each run carries a contact’s state as of run time, so re-runs self-heal
updates for contacts created inside the window. A contact created before the window is not
re-exported when it later changes — for a full refresh, run a one-time export over all history.
Columns
| Column | Status | Description |
|---|
id | Locked | Contact ID — the row grain and dedup key. |
created_at | Locked | The contact’s original creation time (UTC). |
Identity
| Column | Status | Description |
|---|
name | Optional | Contact name. |
email | Optional | Primary email. |
phone | Optional | Primary phone. |
location | Optional | Location label. |
Location & device
| Column | Status | Description |
|---|
city | Optional | City. |
state | Optional | State or region. |
country | Optional | Country. |
device_type | Optional | Most recent device type. |
os | Optional | Most recent operating system. |
browser | Optional | Most recent browser. |
language | Optional | Most recent browser language. |
Timestamps
| Column | Status | Description |
|---|
updated_at | Optional | When the contact was last updated (UTC). |
Company
| Column | Status | Description |
|---|
primary_company_id | Optional | The contact’s primary company ID — joins to the Companies dataset’s id. |
Custom fields
Your space’s custom contact fields, by slot. The slot number determines its type:
| Slots | Type |
|---|
profile_field_1 – profile_field_15 | Text |
profile_field_16 – profile_field_25 | Number |
profile_field_26 – profile_field_30 | Date |
Output naming is your choice at creation. Custom-field columns can be named by their stable
slot (profile_field_7) or by the field’s label (frozen as of creation). With label naming,
renaming a field later does not change an existing export’s columns.
Identity graph
The contact’s full multi-value identity, exported as JSON arrays. All optional and default to off. Values inherited from contacts merged into this one are included, and the lists are uncapped (unlike the Public API’s recent-5 token list).
| Column | Status | Description |
|---|
emails | Optional | JSON array of all the contact’s emails. |
phones | Optional | JSON array of all the contact’s phones. |
comet_tokens | Optional | JSON array of all the contact’s Comet tokens (browser identifiers). |
merged_profile_ids | Optional | JSON array of the contact IDs merged into this contact — your repair kit for event rows exported before a merge. |
