Delete a contact

DELETE /contacts/v1/contact/vid/:contact_id

Method Details

HTTP Methods:

DELETE

Response Format:

json

Requires Authentication?

Yes

Rate Limited?

Yes

Headers

User-Agent

Products:

Marketing & CRM

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.

Responses:
  • 200 when a contact is deleted
  • 401 when an unauthorized request is made
  • 404 when the contact vid does not exist
  • 500 when an internal server error occurs