POST/api/v1/contacts

Create a contact

Creates a contact in your project. Provide email in the data object; set status to active, unsubscribed, or unreachable when you include it.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 body field

Contact details in a data object.

dataobjectoptional
Custom contact fields as an object.

1 status code
200Returns the created contact object, including its identifier, contact details, and timestamps.
dataobjectoptional

Error handling

email is required within data. If provided, status must be one of active, unsubscribed, or unreachable.