Create Sales Orders In Bulk

Create up to 50 sales orders in one call. The whole call costs a single request against
your rate limit no matter how many orders it carries, so a backfill that would otherwise
need one request per order fits in a fraction of the quota.

Every order is validated and stored on its own: one rejected order does not hold back the
rest of the batch, and nothing another order does can roll it back. The response carries
one result per submitted order, in the order they were sent, each tagged with the index
it had in orders so it can be matched back to the payload.

As long as the batch itself is well formed the response is a 200 - even when every order
inside it was rejected. Read meta and the per-order status rather than the HTTP status
code alone. A 400 means the batch was never processed at all: orders was missing, empty
or held more than 50 entries.

seller_order_id still has to be unique for its channel, and that includes within a single
batch: send the same pair twice and the second one is rejected with error code 4003.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
orders
array of objects
required
length between 1 and 50

The sales orders to create, between 1 and 50 of them

orders*
integer
required

Consumer ID

integer
required
string
enum
required
string
required

the external order ID, must be unique across the channel

string
required

Currency code (USD, EUR, etc.)

order_items
array of objects
required

Array of Sales Order Items

order_items*
number
required
ship_to
object
bill_to
object
tracking_codes
array of objects

Array of Tracking codes

tracking_codes
contact
object

Consumer model

sales_order_delivery_dates
object
date-time | null

Date and time

date-time | null

Order shipped date and time

string
enum

Specifies the shipment service level category.

Allowed:
custom_fields
array of objects

Array of CustomField items

custom_fields
Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json