There's a new version of the HubSpot API

As of November 30, 2022, HubSpot API keys are no longer a supported authentication method for accessing HubSpot APIs. Instead, you should use a private app access token or OAuth to authenticate API calls. Learn more about this change and how to migrate an API key integration to use a private app instead.

Delete a Deal

Last updated May 31, 2023

DELETE /deals/v1/deal/:dealId

Method Details

HTTP Methods:

DELETE

Response Format:

N/A

Requires Authentication?

Yes

Rate Limited?

Yes

Headers

User-Agent

Products:

CRM

Required Scope:

crm.objects.deals.write

Deletes the exisiting deal specified by :dealId.

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.
Deal Id Used in the request URL (see above) Unique identifier for a particular deal.