Update an existing contact
Update a contact’s information. Custom field values can be set by including custom.cf_* keys in the request body, e.g. "custom.cf_abc123": "value".
For custom fields that accept multiple values, you can use .add or .remove suffixes to modify the existing list without replacing it:
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
Query parameters
Comma-separated list of fields to include in the response.
Request
IANA timezone ID to set manually for the contact, e.g. America/New_York. Send null to clear it, so the timezone is inferred from the contact’s phone numbers instead. Omit to leave it unchanged
Job title of the contact, e.g. CEO. Omit or send null to leave it unchanged
Response
ID of the user who created the contact, e.g. user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA
Name to display for the contact: the contact’s name if set, otherwise the first email address, then the first phone number in international format, then Unnamed
The contact’s ID, e.g. cont_q4xYmlGhA3060dEl0NDJuHRxPMuVjqLn30AFSzh1fRk
The owning organization’s ID, e.g. orga_RbREgmiiwcr1w2b4cOnCMQaQPSIFxMqAD2Dh243uxcH
Job title of the contact, e.g. CEO, or null if unset
ID of the user who last updated the contact, e.g. user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA
The owning lead’s ID, e.g. lead_etYl6PwL12hkj14567kjolJwZuZehb9b85EDH9CKuAI. Every contact belongs to exactly one lead. Always returned, even when not requested in _fields.
IANA timezone ID of the contact, e.g. America/New_York. Set manually, or else inferred from the contact’s phone numbers. Null if neither is available. See timezone_source.
Where timezone came from: manual if set explicitly, inferred_from_phone_number if derived from the contact’s phone numbers, or null if timezone is null