---
title: "Update Contact"
method: PATCH
path: "/v1/update-contact"
---

# Update Contact

`PATCH /v1/update-contact`

Updates an existing contact. Only provided fields will be updated, others remain unchanged.

## Request body

- object
  - `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 `200`

Contact updated successfully

- object
  - `contact_id` string, uuid

## Other responses

- `400` — Invalid request

---

[API](https://skmtc.dev/telli/apis/telli-api.md) · [All operations](https://skmtc.dev/telli/apis/telli-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/telli/telli-api/revisions/9815a3c63c75/schema)