---
title: "Time off request declined"
method: POST
path: "timeoffRequestDeclined"
tags: ["Time off Webhooks"]
---

# Time off request declined

`POST timeoffRequestDeclined` (webhook)

Triggered when declining a time off request.

When using the **getApi** URL to retrieve details of a declined request, the status in the response will be **disapproved** (not "declined").

In the right panel, open **Examples** and select **Payload Example** to see a real payload.

## Headers

- `bob-signature` string, required

## Payload

- TimeoffRequestDeclinedEvent: Base webhook event structure containing common webhook properties
  - `companyId` number, required: The company ID
  - `type` 'timeoff.request.declined', required: Event type for time off request declined
  - `triggeredBy` string, required: The backend-id of the employee that triggered the event, or 'system' for system-triggered events
  - `triggeredAt` string, required: The timestamp when the event occurred (ISO 8601-style string)
  - `version` string, required: The webhook version (e.g., v2)
  - `data` object, required: Data payload for timeoff.request.declined event
    - `timeoffRequestId` integer, required: The unique identifier of the time off request
    - `employeeId` string, required: The unique identifier of the employee
    - `getApi` string, required: URL to retrieve the full time off request details via the API

## Acknowledgement `200`

Webhook received successfully

## Other responses

- `400`: Invalid webhook payload

---

[API](https://skmtc.dev/hibob/apis/time-off-api.md) - [All operations](https://skmtc.dev/hibob/apis/time-off-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hibob/apis/time-off-api/revisions/879ed4afa950?raw)