curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.sync.stateset.com/v1/tenants/{tenant_id}/cart/orders' \
--header "x-stateset-api-key: $STATESET_SYNC_API_KEY" \
--header 'Content-Type: application/json' \
--data @cart-order.json
{
"meta": {
"requestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
},
"data": {
"success": true,
"externalId": "string",
"statusCode": 1,
"response": {}
}
}
Create an order in Cart.com
Creates an order through the tenant’s configured Cart.com integration…
POST
/
v1
/
tenants
/
{tenant_id}
/
cart
/
orders
curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.sync.stateset.com/v1/tenants/{tenant_id}/cart/orders' \
--header "x-stateset-api-key: $STATESET_SYNC_API_KEY" \
--header 'Content-Type: application/json' \
--data @cart-order.json
{
"meta": {
"requestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
},
"data": {
"success": true,
"externalId": "string",
"statusCode": 1,
"response": {}
}
}
Creates an order through the tenant’s configured Cart.com integration. Save the complete payload approved for your Cart.com connection as cart-order.json before running this example. Local validation requires one nonempty order identifier and one nonempty item array from the alternatives below. The payload is forwarded downstream; these checks do not describe every field Cart.com requires. Read the per-integration response and reconcile the created order before retrying an uncertain result.
Path parameters
string
required
Tenant identifier
Request body
object
string
orderId: One supported order-identifier field. Supply at least one non-whitespace identifier.string
order_id: One supported order-identifier field. Supply at least one non-whitespace identifier.string
orderNumber: One supported order-identifier field. Supply at least one non-whitespace identifier.string
order_number: One supported order-identifier field. Supply at least one non-whitespace identifier.string
externalId: One supported order-identifier field. Supply at least one non-whitespace identifier.string
external_id: One supported order-identifier field. Supply at least one non-whitespace identifier.string
clientOrderId: One supported order-identifier field. Supply at least one non-whitespace identifier.any[]
items: One supported item-array field. Supply at least one nonempty array; item content must follow your configured Cart.com contract. Minimum items: 1.any[]
lineItems: One supported item-array field. Supply at least one nonempty array; item content must follow your configured Cart.com contract. Minimum items: 1.any[]
line_items: One supported item-array field. Supply at least one nonempty array; item content must follow your configured Cart.com contract. Minimum items: 1.Response
object
object
required
Status codes
| Code | Meaning |
|---|---|
200 | Cart.com order creation result |
401 | Unauthorized |
422 | Validation error |
424 | Cart.com integration not configured |
502 | Cart.com API error |
Using this contract
Read the source OpenAPI document for declared schemas and alternatives. This page also includes documented corrections from the spec overlays. Example IDs and values are illustrative; replace them with records from your workspace.curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.sync.stateset.com/v1/tenants/{tenant_id}/cart/orders' \
--header "x-stateset-api-key: $STATESET_SYNC_API_KEY" \
--header 'Content-Type: application/json' \
--data @cart-order.json
{
"meta": {
"requestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
},
"data": {
"success": true,
"externalId": "string",
"statusCode": 1,
"response": {}
}
}
Last modified on September 21, 2026