Create a new contact
Contacts belong to exactly one Lead (specified by lead_id). If you do not provide a lead_id then a new lead will be created, named after the contact.
Custom field values can be set by including custom.cf_* keys in the request body, e.g. "custom.cf_abc123": "value".
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
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. If omitted or null, the timezone is inferred from the contact’s phone numbers
Job title of the contact, e.g. CEO
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