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"
}'
{
"statesetOrderId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
Create a new order in StateSet
Order created successfully
POST
/
v1
/
tenants
/
{tenant_id}
/
orders
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"
}'
{
"statesetOrderId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
Path parameters
Request body
CreateOrderRequest
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.Response
CreateOrderResponse
Status codes
| Code | Meaning |
|---|---|
201 | Order created successfully |
401 | Unauthorized - invalid or missing API key |
422 | Validation error |
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"
}'
{
"statesetOrderId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
Last modified on August 31, 2026