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

# POST /tasks/

`POST /tasks/`

## Query parameters

- `format` 'json' | 'xml'
- `order__orderer__company` string
- `order__orderer__company__icontains` string
- `order__orderer__company__iexact` string
- `order__orderer__company__istartswith` string
- `order__orderer__emails__contained_by` string
- `order__orderer__emails__contains` string
- `order__orderer__emails__overlap` string
- `order__orderer__name` string
- `order__orderer__name__icontains` string
- `order__orderer__name__iexact` string
- `order__orderer__name__istartswith` string
- `order__orderer__notes` string
- `order__orderer__notes__icontains` string
- `order__orderer__notes__iexact` string
- `order__orderer__notes__istartswith` string
- `order__orderer__phones__contained_by` string
- `order__orderer__phones__contains` string
- `order__orderer__phones__overlap` string

## Request body

- 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

## 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)