timeOff

Create time-off request

Submits a new time-off request for a worker under a given policy. Use POST /rest/time_offs/validate first to confirm eligibility, balances, and any required custom-field answers, since the request must satisfy the policy's validation rules to succeed. Requests stay in REQUESTED status until approved or rejected via POST /rest/time_offs/review — unless use_deel_approval_flow is set to true, which routes the request through Deel's own approval flow instead.

Token scopes: time-off:write, worker:write

post/time_offs

Request

  • Base URL: https://api.letsdeel.com/rest
  • URL: https://api.letsdeel.com/rest/time_offs
  • Auth: HTTP bearer

Request body

Response

Time off creation data

Changes

No recorded changes to this operation across all 1 revision of this API.