---
title: "POST /orders/"
method: POST
path: "/orders/"
tags: ["orders"]
---

# POST /orders/

`POST /orders/`

## Request body

- OrderSerializerV2
  - `id` string, uuid, nullable
  - `url` string, uri, required
  - `account` string, uri, required
  - `external_id` string, nullable
  - `reference` string
  - `client` string, uri
  - `orderer` NestedContact
    - `name` string
    - `company` string
    - `phones` string[]
    - `emails` string[]
    - `notes` string
  - `tasks` string[]
  - `tasks_data` TaskSerializerV2[]
    - `id` string, uuid, nullable
    - `external_id` string, nullable
    - `reference` string
    - `barcodes` string[]
    - `url` string, uri, required
    - `account` string, uri, required
    - `state` 'unassigned' | 'assigned' | 'accepted' | 'transit' | 'active' | 'completed' | 'failed' | 'cancelled', required
    - `assignee` string, uri, nullable
    - `order` string, uri, nullable
    - `orderer` string, uri, nullable
    - `orderer_name` string, required
    - `route` string, uri, nullable
    - `category` 'assignment' | 'pick_up' | 'drop_off' | 'warehouse'
    - `contact` NestedContact
      - `name` string
      - `company` string
      - `phones` string[]
      - `emails` string[]
      - `notes` string
    - `address` NestedAddress
      - `raw_address` string
      - `formatted_address` string
      - `location` Location
        - `type` 'Point', required
        - `coordinates` number[], required
      - `google_place_id` string
      - `point_of_interest` string
      - `street` string
      - `house_number` string
      - `apartment_number` string, nullable
      - `city` string
      - `state` string
      - `postal_code` string
      - `country` string
      - `country_code` string
      - `geocoded_at` string, date-time, required
      - `geocode_failed_at` string, date-time, required
    - `contact_address` string, uri, nullable
    - `contact_address_external_id` string, nullable
    - `description` string
    - `complete_after` string, date-time, nullable
    - `complete_before` string, date-time, nullable
    - `scheduled_time` string, date-time, nullable
    - `completed_at` string, date-time, required
    - `cancelled_at` string, date-time, required
    - `auto_assign` boolean
    - `assignee_proximity` 'away' | 'near', required
    - `position` number, double, nullable
    - `priority` integer
    - `duration` object, nullable
    - `size` integer[], nullable
    - `forms` object, required
    - `documents` string[]
    - `signatures` string[]
    - `metafields` object
    - `trackers` string[], required
    - `issues` string[], required
    - `counts` object, required
    - `actions` object, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `documents` string[], required
  - `auto_assign` boolean
  - `description` string
  - `created_by` string, uri, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Response `201`

---

[API](https://skmtc.net/oeklo/apis/gsmtasks-project-api.md) · [All operations](https://skmtc.net/oeklo/apis/gsmtasks-project-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oeklo/gsmtasks-project-api/revisions/2557a8fec764/schema)