Update Contact
update_contactUpdate a Tidio contact's details like email, phone, name, consent, or custom properties. Pass only fields to change; omitted fields stay the same.
Instructions
Update a specific contact in Tidio. Pass only the fields you want to update. Omitted fields remain unchanged; null clears the field (except distinct_id, which cannot be cleared).
Args: contact_id (str): Required. The UUID of the contact to update. email (str, optional): Contact email address in RFC822 format. phone (str, optional): Contact phone number. first_name (str, optional): Contact's first name. last_name (str, optional): Contact's last name. email_consent (str, optional): Email consent status. Must be one of: 'subscribed', 'unsubscribed'. distinct_id (str, optional): External system identifier. Maximum 55 characters. Cannot be cleared (null is not accepted). properties (list, optional): List of custom contact properties to update. Each item must be a dict with 'name' (max 128 chars) and 'value' (max 1000 chars) fields. Example: [{"name": "plan", "value": "premium"}, {"name": "score", "value": 42}]
Returns: Dict: A dictionary with success status.
Raises: ValueError: If any of the provided arguments have invalid values.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| No | |||
| phone | No | ||
| last_name | No | ||
| contact_id | Yes | ||
| first_name | No | ||
| properties | No | ||
| distinct_id | No | ||
| email_consent | No |