Skip to main content
POST
/
v1
/
add-contact
Add Contact
curl --request POST \
  --url https://api.telli.com/v1/add-contact \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "external_contact_id": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "phone_number": "<string>",
  "external_url": "<string>",
  "salutation": "<string>",
  "email": "[email protected]",
  "contact_details": {},
  "timezone": "<string>"
}
'
{
  "contact_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

​
Authorization
string
header
required

API key must be provided as: Bearer <api_key>

Body

application/json
​
external_contact_id
string
required

Your unique internal identifier for the contact

​
first_name
string
required
​
last_name
string
required
​
phone_number
string
required

Contact's phone number in E.164 format (e.g. +4917642048466)

​
external_url
string<uri>

External URL linking to the contact in your CRM or external system

​
salutation
string

Formal title or greeting (e.g. 'Mr.', 'Ms.', 'Herr', 'Frau'). If empty, will auto guess based on first name for German calls.

​
email
string<email>
​
contact_details
object

Custom variables passed to the AI agent (should be discussed in advance). Please send variables in lowercase snake_case. This used to be called dynamic_variables, which still works but is deprecated and should be replaced with contact_details. Alternatively, you can send contact_details_ in the body instead of an object.

​
timezone
string

IANA timezone identifier (e.g. Europe/Berlin). Defaults to account timezone if not set

Response

Contact created successfully

​
contact_id
string<uuid>