---
title: "Create a fulfillment for an order"
method: POST
path: "/open-api/v1.0/fulfillments"
tags: ["Fulfillment"]
---

# Create a fulfillment for an order

`POST /open-api/v1.0/fulfillments`

*Rate limit: 100 requests / 10 seconds per shop. See [Rate limiting](/guides/rate-limiting).*

Creates a fulfillment with a shipment tracker for provided order items. When trackers change their state, order.status will change to IN_PRODUCTION, PARTIALLY_IN_PRODUCTION, PARTIALLY_SHIPPED, SHIPPED depending on the shipping tracker info. Order updated webhooks will be triggered.

## Request body

- ComFourthwallAppOpenapiEndpointFulfillmentRequest
  - `orderId` string, uuid, required
  - `items` ComFourthwallAppOpenapiEndpointFulfillmentItem[], required
    - `variantId` string, uuid, required
    - `quantity` integer, required
  - `shippingLabel` ComFourthwallAppOpenapiEndpointShippingLabel, required
    - `trackingNumber` string, required
    - `trackingCompany` string, required

## Response `201`

Created

- ComFourthwallAppOpenapiEndpointFulfillmentResponse
  - `fulfillmentId` string, required

## Other responses

- `400` — Possible errors: `FULFILLMENT_ALREADY_EXISTS`, `FULFILLMENT_ORDER_INVALID_VARIANT`, `FULFILLMENT_VARIANT_QUANTITY_TO_HIGH`
- `404` — Possible errors: `FULFILLMENT_INVALID_SHOP_ORDER`, `FULFILLMENT_ORDER_NOT_FOUND`, `OFFER_VARIANT_NOT_FOUND_ERROR`, `ORDER_ID_NOT_FOUND`
- `429` — Rate limited: 100 requests / 10 seconds per shop.

---

[API](https://skmtc.net/fourthwall/apis/fourthwall-apis-2.md) · [All operations](https://skmtc.net/fourthwall/apis/fourthwall-apis-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fourthwall/fourthwall-apis-2/revisions/ef273312f051/schema)
