Skip to main content
POST
/
email
/
contacts
/
bulk-upsert
Upsert multiple email contacts
curl --request POST \
  --url http://localhost/public/v1/email/contacts/bulk-upsert \
  --header 'Content-Type: application/json' \
  --data '
{
  "contacts": [
    {
      "email": "[email protected]",
      "first_name": "<string>",
      "last_name": "<string>",
      "phone": "<string>",
      "foreign_id": "<string>",
      "country_code": "<string>",
      "custom_str_1": "<string>",
      "custom_str_2": "<string>",
      "custom_str_3": "<string>",
      "custom_str_4": "<string>",
      "custom_str_5": "<string>",
      "custom_int_1": 123,
      "custom_int_2": 123,
      "custom_int_3": 123,
      "custom_int_4": 123,
      "custom_int_5": 123,
      "custom_dec_1": 123,
      "custom_dec_2": 123,
      "custom_dec_3": 123,
      "custom_datetime_1": "2023-11-07T05:31:56Z",
      "custom_datetime_2": "2023-11-07T05:31:56Z",
      "custom_datetime_3": "2023-11-07T05:31:56Z",
      "custom_bool_1": true,
      "custom_bool_2": true,
      "custom_bool_3": true
    }
  ],
  "tags": [
    "<string>"
  ]
}
'
{
  "ok": true,
  "contacts": "<string>",
  "count": "<string>"
}

Body

application/json
contacts
object[]
required

Required. Array of contact objects to upsert.

Required array length: 1 - 1000 elements
tags
string[] | null

Optional. Array of tags to apply to all contacts.

Maximum array length: 50

Optional. Tag values must be strings with max 100 characters.

Maximum string length: 100

Response

ok
boolean
required
contacts
string
required
count
string
required