---
title: "POST Trade"
method: POST
path: "/trades"
---

# POST Trade

`POST /trades`

## Request

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

/trades
Permission level: 5

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

- object
  - `tradewith` string, required: Array of employees ids (eg. "234,563,770")
  - `reason` string, required
  - `shift` integer, required

## Response `200`

200

- object
  - `status` integer
  - `data` object
    - `id` integer
    - `status` integer
    - `user` object
      - `id` string
      - `name` string
    - `shift` object
      - `id` string
      - `created` string
      - `published` string
      - `edited` string
      - `deleted` string
      - `schedule` string
      - `type` string
      - `needed` string
      - `working` string
      - `user` string
      - `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
        - `iso8601` 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
        - `iso8601` 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` string
      - `notes` string
      - `confirmed` string
      - `ref` string
      - `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` string
        - `cost` integer
      - `employeesOnCall` unknown
      - `cost` object
        - `staff` integer
        - `hours` integer
        - `dollars` integer
      - `repeats` string
      - `staff` unknown
      - `break` unknown
      - `conflicts` unknown
      - `conflicts_types` unknown
      - `conflict_types` unknown
      - `requests` unknown
      - `trades` object[]
        - `trade_id` string
        - `id` string
        - `name` string
    - `reason` string
    - `date` integer
    - `confirm_before` integer
    - `confirm_after` integer
    - `trade_to` integer
    - `swap` integer
    - `receivers` object[]
      - `user` object
        - `id` string
        - `name` string
      - `confirmed` integer
      - `approved` integer
  - `error` unknown

## Other responses

- `400`: 400

## Changes

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

[Operation history](https://skmtc.dev/humanity-com/apis/humanity/changes/trades/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)
