POST

Create Order

Creates an order.

Use this endpoint to create manual orders for phone or email sales or to add orders from external systems (such as POS, marketplaces, or legacy platforms). For standard online purchases, orders are created automatically through the checkout flow.

To record payment information for the order, pass the order ID to Add Payments.

Notes:

  • Inventory is automatically reduced when the order is placed (default) or when the order is paid. This can be configured per order creation in the settings.orderApprovalStrategy field in the body params. To configure this behavior for all orders, use the Orders Settings API.
  • A confirmation email is sent when the order is approved.
  • If an item is digital - lineItems[i].itemType.preset: DIGITAL - then lineItems[i].digitalFile must be provided.
  • If lineItems[i].id is passed, it must be either a valid GUID, or empty.
Authentication

You can only call this method when authenticated as a Wix app or Wix user identity.

Permissions
Manage Orders
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/ecom/v1/orders
Errors
428Failed Precondition

There is 1 error with this status code.

This method may also return standard errors. Learn more about standard Wix errors.

Event TriggersThis method triggers the following events:
Order Created
Did this help?