> For the complete documentation index, see [llms.txt](https://docs.getpurpledot.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getpurpledot.com/docs/purple-dot-apis/private-api/fulfillment.md).

# /fulfillment

## Create a fulfillment

> Creates a fulfillment for a fulfillment order.

```json
{"openapi":"3.1.0","info":{"title":"Purple Dot Private API","version":"v1"},"tags":[{"name":"/fulfillment"}],"servers":[{"url":"https://www.purpledotprice.com/admin/api/v1","description":"Production"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"apiKey","in":"header","name":"X-Purple-Dot-Access-Token","description":"Your store's private access token. It can also be sent as `Authorization: Bearer <token>`."}},"schemas":{"AuthErrorResponse":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]},"ErrorResponse":{"type":"object","properties":{"meta":{"type":"object","properties":{"error":{"type":"string","description":"Human-readable message."},"errorData":{"type":"object","additionalProperties":{},"description":"Structured detail about the error."}},"required":["error","errorData"]},"data":{"type":"object","properties":{}}},"required":["meta","data"]}}},"paths":{"/fulfillment":{"post":{"tags":["/fulfillment"],"summary":"Create a fulfillment","description":"Creates a fulfillment for a fulfillment order.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fulfillment":{"type":"object","properties":{"fulfillment_order_id":{"type":"string"},"line_items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"quantity":{"type":"number"}},"required":["id","quantity"],"additionalProperties":false}},"notify_customer":{"type":"boolean"},"tracking_info":{"type":"object","properties":{"number":{"type":"string"},"url":{"type":"string"}},"additionalProperties":false}},"required":["fulfillment_order_id"],"additionalProperties":false}},"required":["fulfillment"],"additionalProperties":false}}}},"responses":{"200":{"description":"The fulfillment was created.","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"type":"object","properties":{"result":{"type":"string","enum":["success"]}},"required":["result"]},"data":{"type":"object","properties":{"success":{"type":"boolean","enum":[true]}},"required":["success"]}},"required":["meta","data"]}}}},"400":{"description":"Missing access token. Invalid body, or a line item is not in the fulfillment order.","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/AuthErrorResponse"},{"$ref":"#/components/schemas/ErrorResponse"}]}}}},"401":{"description":"Access token not valid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthErrorResponse"}}}},"404":{"description":"The fulfillment order was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
