curl --request PATCH \
--url https://app.thinnest.ai/api/v1/contacts/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"consent": {
"status": "withdrawn",
"source": "Replied STOP on WhatsApp, 6 Oct"
},
"tags": [
"sky-towers"
]
}
'const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
consent: {status: 'withdrawn', source: 'Replied STOP on WhatsApp, 6 Oct'},
tags: ['sky-towers']
})
};
fetch('https://app.thinnest.ai/api/v1/contacts/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.thinnest.ai/api/v1/contacts/{id}"
payload = {
"consent": {
"status": "withdrawn",
"source": "Replied STOP on WhatsApp, 6 Oct"
},
"tags": ["sky-towers"]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"id": "cust_4e7b1c9d-2a6f-4385-b0d2-9f6a3e8c1b74",
"phone": "919876543210",
"name": "Asha Rao",
"email": "asha.rao@gmail.com",
"externalId": "LSQ-42",
"tags": [
"sky-towers"
],
"language": "Hindi",
"note": "Wants a 3BHK, east-facing, ready by March.",
"consent": {
"status": "withdrawn",
"source": "Replied STOP on WhatsApp, 6 Oct",
"recordedAt": "2026-10-06T11:05:37.640Z"
},
"source": "api",
"acquiredFrom": null,
"createdAt": "2026-09-17T09:40:02.311Z"
}Update Contact
Changes any of the fields Create Contact takes, consent included; fields you leave out keep their values, and null clears a field. tags replaces the whole list. A contact whose consent is withdrawn is never sent marketing, enrolled in a sequence or put in a campaign. A build key may do this.
curl --request PATCH \
--url https://app.thinnest.ai/api/v1/contacts/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"consent": {
"status": "withdrawn",
"source": "Replied STOP on WhatsApp, 6 Oct"
},
"tags": [
"sky-towers"
]
}
'const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
consent: {status: 'withdrawn', source: 'Replied STOP on WhatsApp, 6 Oct'},
tags: ['sky-towers']
})
};
fetch('https://app.thinnest.ai/api/v1/contacts/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.thinnest.ai/api/v1/contacts/{id}"
payload = {
"consent": {
"status": "withdrawn",
"source": "Replied STOP on WhatsApp, 6 Oct"
},
"tags": ["sky-towers"]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"id": "cust_4e7b1c9d-2a6f-4385-b0d2-9f6a3e8c1b74",
"phone": "919876543210",
"name": "Asha Rao",
"email": "asha.rao@gmail.com",
"externalId": "LSQ-42",
"tags": [
"sky-towers"
],
"language": "Hindi",
"note": "Wants a 3BHK, east-facing, ready by March.",
"consent": {
"status": "withdrawn",
"source": "Replied STOP on WhatsApp, 6 Oct",
"recordedAt": "2026-10-06T11:05:37.640Z"
},
"source": "api",
"acquiredFrom": null,
"createdAt": "2026-09-17T09:40:02.311Z"
}Authorizations
Headers
Developers only: the customer workspace this request acts in — its org_… id from POST /customers. Leave it out to act in your own workspace. Refused with 404 (Workspace not found.) when the id is unknown, is not one of your customers, or is not an org_… id; 410 when that customer was deleted (restore it with POST /customers/{id}/restore until it is erased); 403 when the key belongs to one customer workspace (it cannot act as another); 400 when your workspace is not a developer workspace. /customers/* and GET /customers/usage are your own workspace's and refuse the header with 400: call them without it.
"org_3fKq9TzQ1mN8vB2xR7cLpA"
Body
Any subset of the create fields; at least one. Fields left out keep their values.
The language to write to them in, auto, or null.
auto, English, Hindi, Assamese, Bengali, Bodo, Dogri, French, German, Gujarati, Indonesian, Italian, Japanese, Kannada, Kashmiri, Konkani, Korean, Maithili, Malayalam, Manipuri, Marathi, Nepali, Odia, Polish, Portuguese, Punjabi, Russian, Sanskrit, Santali, Sindhi, Spanish, Swahili, Tamil, Telugu, Thai, Turkish, Urdu, Vietnamese, null Response
The contact as saved.