Method Details
HTTP Methods:
POST
Content Type:
application/json
Response Format:
N/A
Requires Authentication?
Yes
Rate Limited?
Headers
Products:
Marketing & CRM
Required Scope:
Update an existing contact in HubSpot, identified by email. This method lets you update the properties of a contact in HubSpot.
To update a contact, you should make an HTTP POST call to this endpoint with some JSON in the request payload. This JSON should contain properties from the contact that you want to add to or update. See the sample JSON to the right for an example of this snippet of JSON.
If you are trying to close a contact into a customer via the API, you should be updating the 'lifecyclestage' property and setting the value of this property to 'customer'.
Remember, if a property doesn't yet exist, you can create a new custom property through the API by using the 'Create Property' method.
Note: This endpoint will return a 404 if there is no existing record with the specified email address. If you're looking to automatically create or update contacts using the email address, you can use this endpoint.