There's a new version of the HubSpot API

We're also working on a new documentation website, you're invited to check it out and give us your feedback.

Delete a contact

Last updated May 15, 2023

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

Method Details

HTTP Methods:


Response Format:


Requires Authentication?


Rate Limited?





Marketing & CRM

Required Scope:


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 private app access token Authorization: Bearer {token} header 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:

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.

  • 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