---
title: "Create shift"
method: POST
path: "/shifts"
tags: ["Shifts"]
---

# Create shift

`POST /shifts`

Create a shift in the oldest active workspace that the token has access to. If you need to specify the workspace, we recommend using the [Create team shift](https://dev.frontapp.com/reference/create-team-shift) endpoint instead.

Required scope: `shifts:write`

## Request body

- CreateShift
  - `name` string, required — Name of the shift
  - `color` 'black' | 'grey' | 'pink' | 'purple' | 'blue' | 'teal' | 'green' | 'yellow' | 'orange' | 'red', required — Color of the shift
  - `timezone` string, required — A timezone name as defined in the IANA tz database
  - `times` ShiftIntervals, required
    - `mon` ShiftInterval
      - `start` string, required — Start of shift
      - `end` string, required — End of shift
    - `tue` ShiftInterval
      - `start` string, required — Start of shift
      - `end` string, required — End of shift
    - `wed` ShiftInterval
      - `start` string, required — Start of shift
      - `end` string, required — End of shift
    - `thu` ShiftInterval
      - `start` string, required — Start of shift
      - `end` string, required — End of shift
    - `fri` ShiftInterval
      - `start` string, required — Start of shift
      - `end` string, required — End of shift
    - `sat` ShiftInterval
      - `start` string, required — Start of shift
      - `end` string, required — End of shift
    - `sun` ShiftInterval
      - `start` string, required — Start of shift
      - `end` string, required — End of shift
  - `teammate_ids` ResourceID[], required — List of all the teammate ids who will be part of this shift. Alternatively, you can supply emails as a [resource alias](https://dev.frontapp.com/docs/resource-aliases-1).

## Response `201`

A shift

- ShiftResponse
  - `_links` object, required
    - `self` string — Link to resource
    - `related` object
      - `teammates` string — Link to shift teammates
      - `owner` string — Link to shift owner
  - `id` string, required — Unique identifier of the shift
  - `name` string, required — Name of the shift
  - `color` 'black' | 'grey' | 'pink' | 'purple' | 'blue' | 'teal' | 'green' | 'yellow' | 'orange' | 'red', required — Color of the shift
  - `timezone` string, required — A timezone name as defined in the IANA tz database
  - `times` ShiftIntervals, required
    - `mon` ShiftInterval
      - `start` string, required — Start of shift
      - `end` string, required — End of shift
    - `tue` ShiftInterval
      - `start` string, required — Start of shift
      - `end` string, required — End of shift
    - `wed` ShiftInterval
      - `start` string, required — Start of shift
      - `end` string, required — End of shift
    - `thu` ShiftInterval
      - `start` string, required — Start of shift
      - `end` string, required — End of shift
    - `fri` ShiftInterval
      - `start` string, required — Start of shift
      - `end` string, required — End of shift
    - `sat` ShiftInterval
      - `start` string, required — Start of shift
      - `end` string, required — End of shift
    - `sun` ShiftInterval
      - `start` string, required — Start of shift
      - `end` string, required — End of shift
  - `created_at` number — The timestamp when the shift was created.
  - `updated_at` number — The timestamp when the shift was updated.

---

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