Create a new order in StateSet

Order created successfully

POST /v1/tenants/{tenant_id}/orders

cURL

curl --request POST \
  --url 'https://api.sync.stateset.com/v1/tenants/{tenant_id}/orders' \
  --header "x-stateset-api-key: $STATESET_SYNC_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "createdAt": "2026-08-31T14:22:05Z",
  "externalOrderId": "string",
  "externalPlatform": "string",
  "lineItems": [],
  "locationId": "string",
  "netsuiteId": "string",
  "orderNumber": "M-1001",
  "shopifyOrderId": "1234567890",
  "sourceOrderPayload": null,
  "tags": [
    "priority"
  ],
  "workflowId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}'

201

{
  "statesetOrderId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

Path parameters

tenant_id · string · required

Tenant identifier

Request body

CreateOrderRequest

createdAt · string (date-time) · required

Order creation timestamp

externalOrderId · string

Source order ID on the external channel/platform.

externalPlatform · string

External channel/platform for non-Shopify orders.

lineItems · OrderLineItem[] · required

Order line items

locationId · string

Location ID for fulfillment

netsuiteId · string

NetSuite order ID if synced

orderNumber · string · required

Order number

shopifyOrderId · string · required

Legacy canonical order ID field used by existing StateSet/order storage. For non-Shopify channels, prefer also sending externalPlatform and externalOrderId; the orchestrator will store the canonical key as {platform}:{externalOrderId} while preserving backwards compatibility.

sourceOrderPayload · object

Raw upstream order payload snapshot, persisted for downstream sync jobs.

tags · string[]

Order tags for filtering/categorization

workflowId · string (uuid)

Workflow ID for tracking

Response

CreateOrderResponse

statesetOrderId · string (uuid) · required

Unique StateSet order ID

Status codes

Code	Meaning
201	Order created successfully
401	Unauthorized - invalid or missing API key
422	Validation error

cURL

curl --request POST \
  --url 'https://api.sync.stateset.com/v1/tenants/{tenant_id}/orders' \
  --header "x-stateset-api-key: $STATESET_SYNC_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "createdAt": "2026-08-31T14:22:05Z",
  "externalOrderId": "string",
  "externalPlatform": "string",
  "lineItems": [],
  "locationId": "string",
  "netsuiteId": "string",
  "orderNumber": "M-1001",
  "shopifyOrderId": "1234567890",
  "sourceOrderPayload": null,
  "tags": [
    "priority"
  ],
  "workflowId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}'

201

{
  "statesetOrderId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}