delete
https://api.customerly.io/v2/companies/
Permanently removes a company from your Customerly account. This action is irreversible
and will delete the company and all associated data.
⚠️ Warning: This action cannot be undone. Make sure you really want to delete this company.
How to Identify the Company to Delete
Use any of these identifier formats in the URL path:
1. Customerly Company ID (numeric):
- Example:
DELETE /companies/12345 - The internal numeric ID from Customerly
2. Custom Company ID (prefix: cid:):
- Example:
DELETE /companies/cid:company_abc123 - Your own custom identifier for the company
Response
- 204 No Content: Company successfully deleted (empty response body)
- 404 Not Found: Company doesn't exist
Example Requests
# Delete by Customerly ID
DELETE /companies/12345
# Delete by custom company ID
DELETE /companies/cid:company_abc123Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Company successfully deleted. No content is returned in the response body.
Authentication credentials are missing or invalid. Please check your API key.
You don't have permission to delete companies. Check your account permissions.
Company not found. The identifier doesn't match any company in your account. The company may have already been deleted or never existed.