---
title: "Bulk Create Public Orders"
method: POST
path: "/v2/public/orders/bulk"
tags: ["orders"]
---

# Bulk Create Public Orders

`POST /v2/public/orders/bulk`

## Query parameters

- `workspace_id` string, nullable

## Headers

- `X-Workspace-Code` string

## Request body

- OrderBulkCreateRequest
  - `orders` OrderBulkOrderRequest[]
    - `external_id` string, required
    - `items` OrderLineItemMutationRequest[], nullable
      - `line_item_id` string, nullable
      - `item_id` string, nullable
      - `item_external_id` string, nullable
      - `custom_item_name` string, nullable
      - `quantity` number, nullable
      - `unit_price` number, nullable
      - `tax_rate` number, nullable
      - `tax_type` string, nullable
      - `total_price` number, nullable
      - `total_price_without_tax` number, nullable
      - `currency` string, nullable
      - `row_type` string, nullable
      - `section_label` string, nullable
      - `section_type` string, nullable
      - `custom_fields` object
    - `line_items` OrderLineItemMutationRequest[], nullable
      - `line_item_id` string, nullable
      - `item_id` string, nullable
      - `item_external_id` string, nullable
      - `custom_item_name` string, nullable
      - `quantity` number, nullable
      - `unit_price` number, nullable
      - `tax_rate` number, nullable
      - `tax_type` string, nullable
      - `total_price` number, nullable
      - `total_price_without_tax` number, nullable
      - `currency` string, nullable
      - `row_type` string, nullable
      - `section_label` string, nullable
      - `section_type` string, nullable
      - `custom_fields` object
    - `company_external_id` string, nullable
    - `company_id` string, nullable
    - `delivery_status` string, nullable
    - `order_at` string, date-time, nullable
    - `status` string, nullable
    - `currency` string, nullable
  - `create_missing_items` boolean
  - `trigger_workflows` boolean

## Response `200`

Successful Response

- BulkCreatePublicOrdersApiV2PublicOrdersBulkPost200Envelope
  - `success` true, required
  - `data` object, required
  - `meta` EnvelopeMeta, required
    - `ctx_id` string, required
    - `pagination` PaginationMeta
      - `page` integer, required
      - `page_size` integer, required
      - `total` integer, required
      - `next_cursor` string, nullable
    - `toast` ToastMessage
      - `variant` 'success' | 'error' | 'info' | 'warning', required
      - `code` string, required
      - `message` string, required
      - `i18n` ToastMessageI18n, required
        - `en` string, required
        - `ja` string, required

## Other responses

- `401` — Error response
- `422` — Error response

---

[API](https://skmtc.net/sankahq/apis/sanka-public-api.md) · [All operations](https://skmtc.net/sankahq/apis/sanka-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sankahq/sanka-public-api/revisions/dbb716222666/schema)