Contacts

Update multiple contacts

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

It is important to note that contacts are website visitors who have interacted with the Tidio widget and have been identified by their name, email address, or phone number.

patch/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": [
    {
      "id": "a1b4ca4c-1108-4432-b256-1e4cf2bf6f9e",
      "email": "email@example.com",
      "phone": "123 456 789",
      "first_name": "John",
      "last_name": "Doe",
      "email_consent": "subscribed",
      "properties": [
        {
          "name": "shoe_size",
          "value": "44 (EU)"
        }
      ],
      "distinct_id": "123456"
    }
  ]
}

Response

It means that all the contacts have been updated.

Changes

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