Method Details
HTTP Methods:
POST
Content Type:
application/json
Response Format:
json
Requires Authentication?
Yes
Rate Limited?
Headers
Products:
Marketing & CRM
crm.objects.contacts.write
The create or update a contact endpoint is used to create a new HubSpot contact or update an existing one.
Use case for this endpoint: This method is useful when syncing changes to contacts in other CRMs with your HubSpot contacts.
Response details
If successful, the returned data will include the unique identifier (visitor ID, or vid) of the contact and the request type (create or update).
- Returns a 200 response on success. The response will contain a vid of the updated or created record, and an isNew field that indicates if a new record was created. If the field is false, an existing record was updated.
- Return a 409 Conflict error response if you are trying to update the email address of a record, and there is an existing record with the new email address.
Need to create or update a large number of contacts? Try the Batch API.