---
title: "Create Order Tasks"
method: POST
path: "/orders/{order_handle}/tasks"
tags: ["Orders"]
---

# Create Order Tasks

`POST /orders/{order_handle}/tasks`

## Request

- Base URL: `https://v3.api.hypertrack.com`
- URL: `https://v3.api.hypertrack.com/orders/{order_handle}/tasks`
- Auth: one of:
  - HTTP basic
  - HTTP bearer
- TypeScript: <https://skmtc.dev/hypertrack/apis/hypertrack-api/docs/orders/:order_handle/tasks/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates tasks for an order. The tasks are created based on the provided request parameters. This endpoint is used to manage tasks associated with orders in the system.

## Path parameters

- `order_handle` string, required

## Query parameters

- `fulfillment_attempt` integer, nullable

## Request body

- CreateOrderTasksRequest
  - `tasks` BaseOrderTask[], required: List of task types to be created for the order. Valid values are 'order_summary' and 'order_billing_summary'.
    - `label` string, required: Type of task to be created for the order.
    - `task_definition_id` string, nullable: Id of the tasks definition from which this task is picked
    - `description` string, nullable: Description of the task type.
    - `metadata` object, nullable: Additional metadata for the task.
    - `priority` 'none' | 'low' | 'medium' | 'high' | 'null', nullable: Priority of the task. Valid values are none, low, medium, high.

## Response `201`

Successful response

- CreateOrderTasksResponse
  - `tasks` OrderTaskResponse[], required: List of tasks created for the order.
    - `label` string, required: Type of task to be created for the order.
    - `task_definition_id` string, nullable: Id of the tasks definition from which this task is picked
    - `description` string, nullable: Description of the task type.
    - `metadata` object, nullable: Additional metadata for the task.
    - `priority` 'none' | 'low' | 'medium' | 'high' | 'null', nullable: Priority of the task. Valid values are none, low, medium, high.
    - `task_id` string, required: Unique identifier for the created task.
    - `status` string, nullable: Status of the task. Valid values are pending, ongoing, completed, cancelled.
    - `created_at` string, required: Timestamp when the task was created.
    - `updated_at` string, nullable: Timestamp when the task was last updated.
    - `attachments` union[], nullable: Attachments associated with the event
      - union
        - ImageAttachmentResponse
          - `type` 'image', required: Type of attachment
          - `url` string, required: Image link
          - `caption` string, nullable: Caption for the image
          - `attachment_id` string, nullable
        - NoteAttachmentResponse
          - `type` 'note', required: Type of attachment
          - `data` string, required: Text for the note
          - `attachment_id` string, nullable
        - SignatureAttachmentResponse
          - `type` 'signature', required: Type of attachment
          - `url` string, required: Signature image link
          - `attachment_id` string, nullable

## Other responses

- `400`: Validation error
- `401`: Authentication error
- `404`: Not Found

---

[API](https://skmtc.dev/hypertrack/apis/hypertrack-api.md) - [All operations](https://skmtc.dev/hypertrack/apis/hypertrack-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hypertrack/apis/hypertrack-api/revisions/389326c4c9c8?raw)