Skip to main content
POST
Create a contact
If you want to “update or create” contacts, consider using the Update a contact endpoint instead.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

You can add custom contact properties as keys in this request (of type string, number, boolean or date. See available date formats). Make sure to create the properties in Loops before using them in API calls.

email
string
required

The contact's email address.

firstName
string

The contact's first name.

lastName
string

The contact's last name.

source
string

A custom source value to replace the default “API”.

subscribed
boolean

Whether the contact will receive campaign and workflow emails. All new contacts are subscribed by default.

userGroup
string

You can use groups to segment users when sending emails. Currently, a contact can only be in one user group. Read more

userId
string

A unique user ID (for example, from an external application).

mailingLists
object

Manage mailing list subscriptions.

Include key-value pairs of mailing list IDs and a boolean denoting if the contact should be added (true) or removed (false) from the list.

Example:
{key}

Response

Successful create.

success
boolean
required
Example:

true

id
string
required
Last modified on July 17, 2026