> ## Documentation Index
> Fetch the complete documentation index at: https://docs.breakroomapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Time Off Created Event

> Receive real-time data when time off is created.

Event type: `time_off_created`.

See [Webhooks overview](https://docs.breakroomapp.com/guides/webhooks/overview.md) for delivery, retries, and matching.

## Payload

**eventType** `string` *required*

Always `time_off_created`.

**requestId** `string` *required*

ID of the API request that triggered the event.

**enterprise** `string` *required*

Enterprise name.

**featureType** `string` *required*

Always `time_off`.

**eventTimestamp** `number` *required*

Unix time (seconds) when the event was dispatched.

**data** `object` *required*

Time off data.

**properties**

**id** `string` *required*

Hashed time off ID. UUID values are sent unchanged.

**assigneeId** `string` *required*

Hashed assignee org-member ID.

**startDatetime** `string` *required*

ISO 8601 start datetime.

**endDatetime** `string` *required*

ISO 8601 end datetime.

**orgId** `string` *required*

Hashed organization ID.

**notes** `string`

Optional notes.

**status** `string` *required*

One of `pending`, `approved`, `denied`. `pending` when the time off needs
approval (for example, a member requested it).

**createdBy** `string`

Hashed org-member ID of the creator.

## Example

```json theme={null}
{
  "eventType": "time_off_created",
  "requestId": "6f1c2a8e-3b1d-4b7a-9d0e-2f5c8a1b4e7d",
  "enterprise": "Acme Corp",
  "featureType": "time_off",
  "eventTimestamp": 1767225600,
  "data": {
    "id": "evt_x5p7l3tg",
    "assigneeId": "orm_7k2m9xqp",
    "startDatetime": "2026-01-10T00:00:00Z",
    "endDatetime": "2026-01-12T23:59:59Z",
    "orgId": "org_3hd8w1zt",
    "notes": "Vacation",
    "status": "pending",
    "createdBy": "orm_7k2m9xqp"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.