Contacts are site visitors who have interacted with the Tidio widget and have been identified by their name, email address, or phone number.

Each contact can have custom properties that can be given by the contact, added by chat operators, or updated by chatbots. Contacts may also have conversations, which include messages from the contact as well as messages to the contact from chat operators or chatbots.

You can use OpenAPI to create a new contact. When creating a contact, you need to provide at least one of the following: email, first_name, last_name, or phone.

Please note that using this method will always add new contacts. No data will be overwritten, even if it includes the email or a distinct_id.

{
  "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)"
    }
  ]
}

{
  "id": "a1b4ca4c-1108-4432-b256-1e4cf2bf6f9e"
}