There's a new version of the HubSpot API
As of November 30, 2022, HubSpot API Keys are being deprecated and are no longer supported. Continued use of HubSpot API Keys is a security risk to your account and data. Your API Keys could be deactivated at any time after Nov. 30th, and we recommend that you migrate to Private Apps as soon as possible so you do not lose business-critical functionality.
HTTP Methods:
DELETE
Response Format:
json
Requires Authentication?
Yes
Rate Limited?
Headers
Products:
Marketing & CRM
crm.objects.contacts.write
Delete an existing contact from a particular HubSpot portal.
If a contact with the same email address interacts with the portal again (via a form submission for example) the contact will be added back into the user interface.
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 ID | Used in the request URL | You must pass the Contact's ID that you're deleting in the request URL. See the example URL below for an example of this. |
Optional Parameters | How to use | Description |
---|---|---|
None | None | No optional parameters for this method. |
Example URL: https://api.hubapi.com/contacts/v1/contact/vid/61571?hapikey=demo
If the request succeeds, you'll get an HTTP 200 response with a JSON object, which represents that you've just deleted the contact out of the system.
The response from this API call are standard REST-style HTTP response codes that mark success or failure, with meta information about the call that was made. There will be no data in the response body.