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 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.