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 Company

Last updated May 12, 2023

DELETE /companies/v2/companies/:companyId

Method Details

HTTP Methods:

DELETE

Response Format:

json

Requires Authentication?

Yes

Rate Limited?

Yes

Headers

User-Agent

Products:

Marketing & CRM

Required Scope:

crm.objects.companies.write

Deletes the exisiting company specified by :companyId. Returns JSON indicating whether or not the specified company was actually deleted.

Since companies play a central role in the CRM, it is a best practice not to delete a company unless your application has created them.

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