---
title: "Update Contacts Batch"
method: PATCH
path: "/v1/update-contacts-batch"
---

# Update Contacts Batch

`PATCH /v1/update-contacts-batch`

Updates multiple contacts in a single request. Limited to 1000 contacts per request. Only provided fields will be updated, others remain unchanged.

## Request body

- object
  - `contacts` object[], required — Array of contacts to update. Maximum 1000 contacts per request.
    - `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`

Contacts updated successfully

- object[]
  - `contact_id` string, uuid — The telli contact ID
  - `status` 'success' | 'error' — Status of the contact update
  - `error` string — Error message (only present for failed updates)

## Other responses

- `400` — Invalid request
- `401` — Unauthorized - Invalid API key

---

[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)