---
title: "POST Shift"
method: POST
path: "/shifts"
---

# POST Shift

`POST /shifts`

## Request

- Base URL: `https://www.humanity.com/api/v2`
- URL: `https://www.humanity.com/api/v2/shifts`
- Auth: API key in query parameter `access_token`

/shifts
Permission level: 3

## Request body `application/x-www-form-urlencoded`

- object
  - `start_time` string, required
  - `end_time` string, required
  - `start_date` string, required
  - `end_date` string, required
  - `schedule` integer, required
  - `employee_id` string: A comma-separated employee IDs which will be assigned to a shift
  - `type` integer: 0 -> Standard, 1 -> Open
  - `needed` integer
  - `notes` string
  - `title` string
  - `confirmed` string: 0 -> Not Confirmed; 1 -> Confirmed
  - `location` integer: Remote Location id

## Response `200`

200

- object
  - `status` integer
  - `data` object
    - `id` integer
    - `created` integer
    - `published` integer
    - `edited` integer
    - `deleted` integer
    - `schedule` integer
    - `type` integer
    - `needed` integer
    - `working` integer
    - `user` integer
    - `start_date` object
      - `id` integer
      - `month` integer
      - `day` integer
      - `wday` integer
      - `year` integer
      - `weekday` string
      - `mname` string
      - `week` integer
      - `dayid` integer
      - `timeid` integer
      - `timeid_exact` integer
      - `formatted` string
      - `time` string
      - `timestamp` integer
      - `hours` integer
      - `minutes` integer
      - `seconds` integer
      - `date` string
      - `day_of_year` string
      - `week_adjusted` integer
      - `sp_wday` integer
    - `end_date` object
      - `id` integer
      - `month` integer
      - `day` integer
      - `wday` integer
      - `year` integer
      - `weekday` string
      - `mname` string
      - `week` integer
      - `dayid` integer
      - `timeid` integer
      - `timeid_exact` integer
      - `formatted` string
      - `time` string
      - `timestamp` integer
      - `hours` integer
      - `minutes` integer
      - `seconds` integer
      - `date` string
      - `day_of_year` string
      - `week_adjusted` integer
      - `sp_wday` integer
    - `length` integer
    - `title` string
    - `location` integer
    - `notes` string
    - `confirmed` integer
    - `ref` integer
    - `start_timestamp` string
    - `end_timestamp` string
    - `perms` string
    - `paidtime` integer
    - `start_time` object
      - `id` integer
      - `time` string
    - `end_time` object
      - `id` integer
      - `time` string
    - `schedule_name` string
    - `schedule_color` integer
    - `employees` object[]
      - `id` string
      - `name` string
      - `avatar` string
      - `status` string
      - `wage` string
      - `last_active` string
      - `rate` string
      - `ratecard` string
      - `present` unknown
      - `cost` integer
    - `employeesOnCall` unknown
    - `cost` object
      - `staff` integer
      - `hours` integer
      - `dollars` integer
    - `repeats` integer
    - `staff` object
      - `scheduled` array[]
        - string[]
      - `vacation` unknown[]
        - unknown
      - `unavail` unknown[]
        - unknown
      - `overlap` array[]
        - unknown[]
          - unknown
      - `mintime` unknown[]
        - unknown
      - `sameday` unknown[]
        - unknown
      - `available` array[]
        - unknown[]
          - unknown
      - `overtime` array[]
        - unknown[]
          - unknown
      - `oncall` unknown[]
        - unknown
    - `break` integer
    - `conflicts` unknown
    - `conflicts_types` unknown
    - `conflict_types` unknown
    - `requests` unknown
    - `trades` unknown
  - `token` string

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `ffb87b44c733`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/humanity-com/apis/humanity/changes/shifts/post.md)

---

[API](https://skmtc.dev/humanity-com/apis/humanity.md) - [All operations](https://skmtc.dev/humanity-com/apis/humanity/llms.txt) - [OpenAPI document](https://skmtc.dev/humanity-com/apis/humanity/revisions/ffb87b44c733?raw)
