Delete a company
Permanently delete a company. Its contacts and opportunities are kept and simply unlinked from it.
DELETE
https://api.centerfy.ai/webhooks/inbound/companies/:id Headers
| Header | Required | Value | Description |
|---|---|---|---|
x-api-key | Yes | your sub-account API key (cfy_…) | Authenticates the request; or use Authorization: Bearer <key>. |
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string (uuid) | Yes | The company id. |
Example
curl -X DELETE "https://api.centerfy.ai/webhooks/inbound/companies/{id}" \
-H "x-api-key: $CENTERFY_API_KEY"import { CenterfyClient } from "@centerfy/sdk";
const centerfy = new CenterfyClient({ apiKey: process.env.CENTERFY_API_KEY! });
const result = await centerfy.companies.delete("<companyId>");
console.log(result);centerfy companies delete <companyId>MCP tool: centerfy_companies_delete (see MCP server)
Response
{
"status": "success",
"deleted": true,
"company_id": "5a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d"
}Errors
400— if the id is not a valid UUID; 404 if the company is not in this sub-account.