---
title: "Fulfill order"
method: POST
path: "/1.0/commerce/orders/{id}/fulfillments"
tags: ["Orders"]
---

# Fulfill order

`POST /1.0/commerce/orders/{id}/fulfillments`

## Request

- Base URL: `https://api.squarespace.com`
- URL: `https://api.squarespace.com/1.0/commerce/orders/{id}/fulfillments`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/squarespace/apis/commerce-api/docs/1.0/commerce/orders/:id/fulfillments/post.ts> (a function with typed inputs; its response is checked against the schema)

Updates the status of a specific order to fulfilled, with options to include shipment information and send a customer notification.

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required
- `User-Agent` string, required

## Request body

- OrderFulfillmentRequest
  - `shipments` CreateOrderShipmentRequest[]: Array of shipment data.
    - `carrierName` string, required: Name of the carrier handling the shipment.
    - `service` string, required: Carrier's level of service for shipping.
    - `shipDate` string, date-time, required: ISO 8601 UTC date and time string. Represents the moment the shipment occurred.
    - `trackingNumber` string, required: Carrier's parcel tracking number.
    - `trackingUrl` string: URL provided by carrier to track the shipment; must adhere to valid URL formatting.
  - `shouldSendNotification` boolean: Indicates whether the customer should receive an email notification about the added shipments.

## Response `204`

No content. The order was successfully fulfilled.

## Other responses

- `400`: Bad request. One or more trackingUrls are invalid, or one or more required fields are missing.
- `404`: The requested Order was not found.
- `409`: Conflict. A request using the provided Order is already in progress.

---

[API](https://skmtc.dev/squarespace/apis/commerce-api.md) - [All operations](https://skmtc.dev/squarespace/apis/commerce-api/llms.txt) - [OpenAPI document](https://skmtc.dev/squarespace/apis/commerce-api/revisions/5dd4b1b7cd38?raw)