Contacts

A contact represents an individual email address in your audience. Each contact belongs to a team and has a subscription status, optional custom properties, list memberships, and topic subscriptions.

​

Contact Status

Every contact has one of five statuses:

​

Custom Properties

Custom properties let you store additional data on each contact beyond the email address and status. You can create properties in the dashboard or via the API.

​

Property Types

Each property can have an optional fallback value that is used when the property is not set on a contact. This is useful for providing defaults in segment conditions and template personalization.

​

Using Properties in Templates

Custom properties are available as merge tags in campaign emails. If a contact has a property called first_name, you can use {{first_name}} in your campaign template. See Template Language for syntax details.

​

Lists

Lists are named, static groupings of contacts. A contact can belong to multiple lists. Use lists to organize contacts by purpose — for example, “Newsletter Subscribers”, “Beta Users”, or “Enterprise Customers”. Lists are managed manually: you add and remove contacts explicitly, either through the dashboard, CSV import, or the API. This is different from segments, which are dynamic and update automatically based on conditions.

​

Subscription Topics

Topics let contacts manage their subscription preferences at a granular level. Instead of a single subscribe/unsubscribe toggle, contacts can opt in or out of specific topics — for example, “Product Updates”, “Weekly Digest”, or “Promotions”. Topics can be public (visible to contacts in preference centers) or private (used internally for segmentation).

​

Double Opt-In

Double opt-in adds a confirmation step when a contact is created. Instead of immediately becoming subscribed, the contact starts as unverified and receives a confirmation email. They become subscribed only after clicking the confirmation link. This is a best practice for GDPR compliance and ensures that only real, engaged email addresses enter your audience.

​

Import and Export

​

CSV Import

Import contacts in bulk from a CSV file:

​

CSV Export

Export your contacts to a CSV file:

1. Go to Audience → Contacts
2. Apply any filters you want (optional)
3. Click Export
4. The export processes in the background and you’ll receive an email with a download link when ready

​

API Access

The API provides full CRUD access to contacts with the audience:read and audience:write scopes. You can create, update, list, and delete contacts programmatically.

​

Next Steps