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

# Employee Deleted

`POST employee.deleted` (webhook)

Triggered when an employee is deleted.

### Behavior & Constraints
- **Permission Checking**: This event does **not** enforce permission checking. The webhook will fire for all subscribers regardless of the API token's field-level permissions.

### Deprecation Notice
**Note:** This event is the modern replacement for the legacy `employee_with_fields.deleted` event. While the legacy event is deprecated, it will remain available for the foreseeable future to support existing integrations. We encourage using this new event for all new development.

**Important:** You cannot subscribe to both this new event and the legacy `employee_with_fields` events on the same webhook. Webhooks created without specifying any events will default to the legacy behavior, effectively subscribing to the `employee_with_fields` events automatically.

## Payload

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

## 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)