POST/v1/contacts

Create contact

Create a new contact with an email address and optional metadata.

Authentication

Requires a Bearer token (API key) in the Authorization header.

Request body

emailstring (email)required

Email address of the contact.

subscribedboolean

Whether the contact is subscribed to receive marketing emails. Defaults to true.

firstNamestring or null

First name of the contact.

lastNamestring or null

Last name of the contact.

propertiesobject

Coming soon - not yet supported. Key-value pairs of custom contact properties.

Response

201—Contact created

{
  "success": true,
  "id": "string"
}

409—A contact with this email already exists

{
  "success": false,
  "message": "string"
}