Contacts

contacts are the people you send to. Store them once and address a message by contactId instead of a raw email, or group them with contact groups for segmented sends.

What you can do

• Manage contacts — create, retrieve, list, update, and remove.
• Bulk operations — import many contacts at once, and bulk-update status or tags.
• Engagement — read a contact's engagement history.
• Export your contacts.

Addressing a contact

Once a contact exists, reference it from the send body instead of an email address:

{
  "to": [{ "contactId": "c0a8011e-0000-4000-8000-000000000001" }],
  "channel": "email",
  "email": { "subject": "Hello", "html": "<p>Hi!</p>" }
}

Shared conventions (auth, status codes, errors, pagination) are in the REST API reference. Per-operation request and response detail is in the sidebar.