---
title: "Create time off"
method: POST
path: "/teammates/{teammate_id}/time_offs"
tags: ["Time Off"]
---

# Create time off

`POST /teammates/{teammate_id}/time_offs`

Create a time off for a teammate.

Required scope: `time_off:write`

## Path parameters

- `teammate_id` string, required

## Request body

- CreateTimeOff
  - `name` string, required — Name of the time off
  - `start_at` number, required — Timestamp when the time off starts (in seconds)
  - `end_at` number, nullable — Timestamp when the time off ends (in seconds), or null if open-ended
  - `auto_responder` object
    - `body` string — The auto-reply message body
    - `is_enabled` boolean — Whether the auto-responder is enabled
    - `is_contacts_only` boolean — Whether the auto-responder only replies to known contacts
    - `channel_ids` ResourceID[] — List of channel IDs the auto-responder applies to

## Response `201`

A time off

- TimeOffResponse
  - `_links` object, required
    - `self` string — Link to the time off resource
    - `related` object
      - `teammate` string — Link to the teammate this time off belongs to
  - `id` string, required — Unique identifier of the time off
  - `name` string, required — Name of the time off
  - `start_at` number, required — Timestamp when the time off starts
  - `end_at` number, nullable — Timestamp when the time off ends, or null if open-ended
  - `created_at` number — Timestamp when the time off was created
  - `updated_at` number — Timestamp when the time off was last updated
  - `auto_responder` object, required
    - `is_enabled` boolean — Whether the auto-responder is enabled
    - `channel_ids` string[] — List of channel IDs the auto-responder applies to
    - `is_contacts_only` boolean — Whether the auto-responder only replies to known contacts
    - `body` string — The auto-reply message body

---

[API](https://skmtc.dev/frontapp/apis/core-api.md) · [All operations](https://skmtc.dev/frontapp/apis/core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/frontapp/core-api/revisions/76d1eaa2d0eb/schema)