Update contact
Set contact properties and add or remove tags on a contact.
MCP tool tidio_write → update_contact
write
Sets the contact properties you pass by name and leaves the others. The property must already exist in Settings > Fields, and the agent cannot create one with it. It sends nothing to the contact, and a wrong value is undone by calling it again, so it needs no confirmation by default. It returns the contact after the change.
Parameters
| Name | Type | Description |
|---|---|---|
| contact_id string required | string | Contact ID from list_contacts. |
| properties object | object | Property names and their new values. |
| add_tags string[] | string[] | Customer tags to add. |
| remove_tags string[] | string[] | Customer tags to remove. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "tidio_write",
"arguments": {
"operation": "update_contact",
"arguments": {
"contact_id": "c4d9e1a2-77b0-4e0f-9a31-5b2c8e6f0d13",
"properties": {
"plan": "customer"
},
"add_tags": [
"vip"
]
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"contact_id": "c4d9e1a2-77b0-4e0f-9a31-5b2c8e6f0d13",
"properties": {
"plan": "customer"
},
"tags": [
"vip"
]
},
"isError": false
}