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

The telli contact ID received when creating the contact

​
first_name
string

First name of the contact

​
last_name
string

Last name of the contact

​
phone_number
string

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

​
contact_details
object

Custom variables passed to the AI agent. The entire object will be overwritten. This used to be called dynamic_variables, which still works but is deprecated and should be replaced with contact_details.

​
salutation
string

Formal title or greeting (e.g. 'Mr.', 'Ms.', 'Herr', 'Frau')

​
email
string<email>

Contact's email address

​
timezone
string

IANA timezone identifier (e.g. Europe/Berlin)

​
external_contact_id
string

Your unique internal identifier for the contact

​
external_url
string<uri>

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

Response

Contact updated successfully

​
contact_id
string<uuid>
⌘I