update_contact

Partially update a contact. Pass only the fields you want to change. Set a nullable field to null to clear it. At least one trait or external_user_id must be present.

required scope: read:write.

example prompts

• “update ctc_01H8…‘s plan to Enterprise and bump mrr_cents to 99000.”
• “clear the external_user_id on this contact — they cancelled and the link is no longer valid.”

input

field	type	required	notes
contact_id	string	yes
external_user_id	string (max 255 chars) | unknown | null	no
email	string (max 320 chars) | unknown | null	no
name	string (max 200 chars) | unknown | null	no
plan	string (max 100 chars) | unknown | null	no
mrr_cents	integer (0-100,000,000) | unknown | null	no
currency	string (regex) | unknown | null	no
metadata	object	no

notes

• mrr_cents and currency must be cleared together; clearing one without the other is rejected.
• Field constraints match create_contact: mrr_cents ≤ 100,000,000; email ≤ 320 chars; metadata ≤ 100 keys.

output

The updated contact row.