Skip to main content
POST
/
contacts
cURL
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

Required array length: 1 - 1000 elements

Response

Contact response

​
synced
integer
⌘I