---
title: "Company Deleted"
method: POST
path: "company.deleted"
tags: ["Webhook Events", "Public API"]
---

# Company Deleted

`POST company.deleted` (webhook)

Triggered when a company status change results in the company being considered deleted/closed.

### Behavior & Constraints
- This event is emitted when the new company status is `DELETED` or `CANCELLED`.
- For other company updates and status changes, the system emits `company.updated`.

## Payload

- CompanyDeletedWebhookPayload — Webhook payload sent when a company is deleted.
  - `type` 'company.deleted' — The event type identifier
  - `timestamp` string, date-time — ISO 8601 timestamp (UTC) when the event was fired
  - `data` object — Event data containing company information
    - `companyId` string — The company ID

## Acknowledgement `200`

Webhook received successfully (200-299 status code).

## Other responses

- `400` — Client error (400-499 status code) - the webhook endpoint intentionally rejected the request. BambooHR will not retry webhooks that return 4xx status codes.
- `500` — Server error (500+ status code). BambooHR will automatically retry this webhook up to 5 times using exponential backoff (5min, 10min, 20min, 40min, 80min intervals).

---

[API](https://skmtc.net/bamboohr/apis/bamboohr-api.md) · [All operations](https://skmtc.net/bamboohr/apis/bamboohr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bamboohr/bamboohr-api/revisions/19ebf391a399/schema)