POST

Create Fulfillment

Creates an order fulfillment.

A line item's quantity can be split across multiple fulfillments. When lineItems[i].quantity isn't passed, it defaults to the line item's remaining unfulfilled quantity.

Notes:

  • Fulfillments can only be created for orders with status: "APPROVED".
  • When passing trackingInfo, both trackingNumber and shippingProvider are required.
  • Don't pass fulfillment.id. It's assigned automatically and passing it results in an error.
  • A shipping notification email may be sent to the buyer when the fulfillment is created, depending on the site's email settings.
  • The order's fulfillmentStatus is recalculated asynchronously after the call.
Authentication

This method may require higher-level permissions than the caller has, based on their identity and roles and permissions. In these cases, you can ensure the method is called with the required level of authorization by using one of the following:

Permissions
Manage Orders
Learn more about app permissions.
Method Declaration
Copy
Errors
409Already Exists

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:
Fulfillments Updated
Did this help?