Update a contact
curl --request PATCH \
--url https://app.usertick.com/api/public/v1/contacts/{contactId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Maya P.",
"attributes": {
"plan": "Business"
}
}
'const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: 'Maya P.', attributes: {plan: 'Business'}})
};
fetch('https://app.usertick.com/api/public/v1/contacts/{contactId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.usertick.com/api/public/v1/contacts/{contactId}"
payload = {
"name": "Maya P.",
"attributes": { "plan": "Business" }
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"id": "77777777-7777-4777-8777-777777777777",
"email": "[email protected]",
"name": "Maya Patel",
"attributes": {
"plan": "Pro",
"company": "Example"
},
"externalId": "user_8271",
"source": null,
"unsubscribedAt": null,
"listIds": [
"88888888-8888-4888-8888-888888888888"
],
"createdAt": "2026-10-01T09:00:00.000Z",
"updatedAt": null
}
Update a contact
Changes a contact’s name, details (the map sent replaces the stored one) or external id, or unsubscribes it. The address can’t change, and a contact can’t be subscribed again (400 CNT-002-004). Recorded in the audit log as made through the credential.
Scopes: contacts:write, contacts:read.
PATCH
/
contacts
/
{contactId}
Update a contact
curl --request PATCH \
--url https://app.usertick.com/api/public/v1/contacts/{contactId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Maya P.",
"attributes": {
"plan": "Business"
}
}
'const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: 'Maya P.', attributes: {plan: 'Business'}})
};
fetch('https://app.usertick.com/api/public/v1/contacts/{contactId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.usertick.com/api/public/v1/contacts/{contactId}"
payload = {
"name": "Maya P.",
"attributes": { "plan": "Business" }
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"id": "77777777-7777-4777-8777-777777777777",
"email": "[email protected]",
"name": "Maya Patel",
"attributes": {
"plan": "Pro",
"company": "Example"
},
"externalId": "user_8271",
"source": null,
"unsubscribedAt": null,
"listIds": [
"88888888-8888-4888-8888-888888888888"
],
"createdAt": "2026-10-01T09:00:00.000Z",
"updatedAt": null
}
Authorizations
bearerAuthapiKeyHeader
Body
application/json
Send at least one field; a field left out (or null) stays as it is. The address never changes.
Response
The contact after the change.
Last modified on November 8, 2026