Create contact

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.

Log in to see full request history
Body Params
string
required
length ≤ 55

ID of the contact in external system

string | null

Email address of the contact [RFC822]

string | null

Phone number of the contact

string | null

First name of the contact

string | null

Last name of the contact

string | null
properties
array of objects
properties
Responses

Language
Credentials
Click Try It! to start a request and see the response here! Or choose an example:
application/json; version=1