Create a new contact

POST /contacts/v1/contact

Method Details

HTTP Methods:


Content Type:


Response Format:


Requires Authentication?


Rate Limited?





Marketing & CRM

Create a new contact in HubSpot with a simple HTTP POST to the Contacts API. The contact will be created instantly inside of HubSpot, and will be assigned a unique ID (vid) that can be used to look up the contact inside of HubSpot later.

Need to create a large number of contacts? Try the Batch API.

Note: This endpoint is designed for offline contacts, and does not support lead tracking. If your contacts come through online forms, use the Form Submission endpoint.

Required Parameters How to use Description
OAuth Access Token or API Key Authorization: Bearer {token} header
or hapikey={key} query parameter.
Used to authenticate the request. Please see this page for more details about authentication.
Contact JSON Used in the request body This is JSON that represents a contact that you're creating. This should be of the format seen in the code sample given.
Optional Parameters How to use Description
Email Address Used in the request body While we recommend that all contact records include an email address, it is possible to create contacts without an email address by leaving out the email property.

Example URL to POST to:

Returns a 200 response on success. The response will include the details for the created contact

Returns a 409 Conflict if there is an existing contact with the email address included in the request. The response body will include the identityProfile details of the contact, which will include the vid of the existing record.