Contacts

Create multiple contacts

The same as [POST] /contacts, but for multiple contacts. Contacts are saved with all or nothing strategy, so all contacts must be valid. The maximum amount of contacts to create in a single request is 100.

post/contacts/batch

Request

Base URL
https://api.tidio.com
URL
https://api.tidio.com/contacts/batch
Auth
API key in header X-Tidio-Openapi-Client-Id and API key in header X-Tidio-Openapi-Client-Secret

Request body

Example request

{
  "contacts": [
    {
      "distinct_id": "123456",
      "email": "email@example.com",
      "phone": "123 456 789",
      "first_name": "John",
      "last_name": "Doe",
      "email_consent": "subscribed",
      "properties": [
        {
          "name": "shoe_size",
          "value": "44 (EU)"
        }
      ]
    }
  ]
}

Response

Created contacts

Example response

{
  "contacts": [
    {
      "id": "a1b4ca4c-1108-4432-b256-1e4cf2bf6f9e",
      "distinct_id": "123456",
      "first_name": "John",
      "last_name": "Doe",
      "email": "email@example.com",
      "phone": "123 456 789",
      "language": "en",
      "country": "US",
      "city": "New York",
      "created_at": "2023-01-01T00:00:00+00:00",
      "email_consent": "subscribed",
      "properties": [
        {
          "name": "shoe_size",
          "value": "44 (EU)"
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.