---
title: "Update contact properties"
method: PATCH
path: "/contacts/{contactId}"
tags: ["Contacts"]
---

# Update contact properties

`PATCH /contacts/{contactId}`

Each contact in Tidio can have a set of defined properties.

It is important to note that contacts are website visitors who have interacted with the Tidio widget and have been identified by their name, email address, or phone number.

These properties include `email`, `first_name`, `last_name`, `phone`, `distinct_id`, and `properties`.
Each property has a specific type, such as `text`, `email`, `number`, `phone`, or URL.
Please note that you can only update contacts that are already [defined in the Tidio panel](https://tidio.com/panel/settings/contact-properties).

Pass only the property you want to update.
1. When the property equals null, it is going to be cleared.
2. When a property does not exist in the body, it stays untouched.
3. Passing any non-existing property will result in a validation error.
4. Passing the wrong property type will result in a validation error.

## Path parameters

- `contactId` string, uuid, required — ID of the contact

## Response `204`

It means that the contact has been updated.

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/tidio/apis/tidio-openapi.md) · [All operations](https://skmtc.net/tidio/apis/tidio-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tidio/tidio-openapi/revisions/60b2d5edc91f/schema)