Create Order

Required permission: write_orders

Create a new order.

Body Params
integer
required
≥ 1

The ID of the store associated with this order.

integer
≥ 1

The ID of the shipping method for this order. Either shipping_method_id or shipping_method_name is required.

string
length ≥ 1

The name of the shipping method. If a shipping method with this name does not exist for the store's client, it will be created. Either shipping_method_id or shipping_method_name is required.

integer
required
≥ 1

The ID of the warehouse fulfilling this order.

string
length ≥ 1

Custom ID of the order from the marketplace or API. If an order with this API ID already exists, you will receive an error.

shipping_address
object
required
string
length ≥ 1

An optional custom order number.

string
length ≤ 255

An optional reference number for the order.

float

The total amount of the order.

date-time

The date and time until which to hold the order.

date-time

The date by which the order must be shipped. Optional; if not provided, the order will not have a required ship date set.

date-time

The date and time of the order. If not provided, the current date and time will be used. If provided, it must be in the past.

string

A note about the packing of the order.

string

A note about the gift of the order.

string

A note about the order for internal use.

string
enum

The type of contents for customs purposes.

string
length ≤ 255

An explanation of the contents for customs purposes.

string
length ≤ 255

A custom field for storing additional order information.

string
length ≤ 255

A custom field for storing additional order information.

string
length ≤ 255

A custom field for storing additional order information.

string
length ≤ 255

A custom field for storing additional order information.

string
length ≤ 255

A custom field for storing additional order information.

string
length ≤ 255

A custom field for storing additional order information.

tags
array of strings
tags
boolean | null

Set address hold to true or false.

boolean | null

Set payment hold to true or false.

boolean | null

Set warehouse hold to true or false.

boolean | null

Set allocation hold to true or false.

boolean | null

Set fraud hold to true or false.

items
array of objects
required
length ≥ 1
items*
integer
≥ 1

The ID of the product in this order item. Required if sku is not provided.

string
length ≥ 1

The SKU of the product in this order item. Required if product_id is not provided. If both are provided, product_id will be used. If only the SKU is provided, but the product does not exist, a new product will be created.

integer
required
≥ 1

The quantity of the product in this order item.

attachments
array of objects
attachments
metadata
object | null

A map of metadata to add to the order. Any fields provided that already exist will be updated, and any fields provided that do not exist will be added.

Responses

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