Create contact
Create a new contact with an email address and any other contact properties.
If you want to “update or create” contacts, consider using the Update a contact endopoint instead.
Request
Body
The contact’s email address.
The contact’s first name.
The contact’s last name.
You can use groups to segment users when sending emails. Currently, a contact can only be in one user group. Read more
Key-value pairs of mailing list IDs and a boolean
denoting if the contact
should be added (true
) or removed (false
) from the list. Read
more
Custom properties
You can also include custom contact properties in your request body. These should be added as top-level attributes in the request.
Custom properties can be of type string
, number
, boolean
or date
(see allowed date formats).
There are a few reserved names that you cannot use for custom properties.
To empty or reset the value of a contact property, send a null
value.
Response
Success
The ID of the new contact.
Error
If a matching contact already exists in your audience, a 409 Conflict
error will be returned. All other errors will be 400 Bad Request
.
An error message describing the problem with the request.
Was this page helpful?