POST

Create Fulfillment


Creates an order fulfillment.

Authentication

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

Permissions
Manage eCommerce - all permissions
Manage Stores - all permissions
Manage Orders
Manage Restaurants - all permissions
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/ecom/v1/fulfillments/orders/{orderId}/create-fulfillment

Path Params
orderIdstringRequired

Order ID.

Body Params
fulfillmentFulfillmentRequired

Fulfillment info.

Response Object
orderWithFulfillmentsOrderWithFulfillments

Order ID and the orders' fulfillments.


fulfillmentIdstring

ID of created fulfillment.

Create Fulfillment

Passing a shipping provider that supports auto-filling the trackingLink in the response.

Request
cURL
curl -X POST \ 'https://www.wixapis.com/ecom/v1/fulfillments/orders/58c9a790-27b7-463f-a865-c7cb494f7c29/create-fulfillment' \ -H 'Content-Type: application/json' \ -H 'Authorization: <AUTH>' \ --data-binary '{ "fulfillment": { "lineItems": [ { "id": "00000000-0000-0000-0000-000000000001", "quantity": 1 } ], "trackingInfo": { "trackingNumber": "12345", "shippingProvider": "fedex" } } }'
Response
JSON
{ "orderWithFulfillments": { "orderId": "58c9a790-27b7-463f-a865-c7cb494f7c29", "fulfillments": [ { "id": "0d824fc7-2621-4e97-a5c8-489ec1b43377", "createdDate": "2023-02-22T15:55:47.021Z", "lineItems": [ { "id": "00000000-0000-0000-0000-000000000001", "quantity": 1 } ], "trackingInfo": { "trackingNumber": "12345", "shippingProvider": "fedex", "trackingLink": "https://www.fedex.com/apps/fedextrack/?action=track&trackingnumber=12345" } } ] }, "fulfillmentId": "0d824fc7-2621-4e97-a5c8-489ec1b43377" }
Errors

This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.

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