Skip to main content
PATCH
string
required
Contact UUID
string
First name
string
Last name
string
Email address
string
Phone number
string
IANA timezone identifier (e.g. America/New_York). Pass null to clear the field. Used by features that respect the contact’s local time. Must be a valid IANA timezone identifier; bogus strings are rejected with 400 Bad Request.
string[]
Tag names to attach to the contact. Tags that don’t exist yet in your workspace are auto-created. Tag attachment is additive — this endpoint never removes a tag. Names are matched case-sensitively, trimmed, and must be 1–255 characters. Omit the field (or pass []) to leave tags unchanged.
object
Custom field values keyed by the custom variable name as displayed in the dashboard (e.g. "Lead Source" — including spaces and original casing; not a slug). Accepts string, number, boolean, or null (null clears a stored value). Values you provide overwrite the existing value for that key; other custom fields on the contact are unaffected. Unknown keys are rejected with a 400. Values are persisted as text and returned as strings.
At least one field must be provided. Unknown top-level fields are rejected with 400 Bad Request. Custom field values must use the customFields object — they cannot be added as top-level fields.