POST
/
contacts
curl --request POST \
  --url https://api.notocat.com/v1/contacts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "newsletter_id": "<string>",
  "contacts": [
    {
      "email": "<string>",
      "name": "<string>",
      "first_name": "<string>",
      "last_name": "<string>",
      "subscribed": true,
      "custom_fields": {}
    }
  ]
}'
{
  "synced": 123
}

The endpoint can be used to create a full list of contacts with Notocat. If a contact already exists, the data will be merged. The contacts can be updated in bulk when provided with IDs or emails that already exist in the database. If the contact does not exist, it will be created with the email provided.

The endpoint accepts a minimum of 1 contact and a maximum of 1000 contacts.

Authorizations

​
Authorization
string
header
required

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

Body

application/json
Contacts to add or update
​
newsletter_id
string
required

The newsletter ID

​
contacts
object[]
required

An array of contacts to add or update

Response

200
application/json
Contact response
​
synced
integer

Was this page helpful?

Suggest editsRaise issue