> 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

#### `POST /fulfillment`

#### Create a fulfillment for a fulfillment order.

Request:

* `fulfillment`
  * `fulfillment_order_id` (UUID) - Required. The ID of the Fulfillment Order you are fulfilling
  * `line_items` (array) - Optional. If left blank, all line items will be fulfilled
    * `id` (string) - Required. The Purple Dot ID of the line item
    * `quantity`(number) - Required. The quantity of that line item that are being fulfilled
  * `notify_customer` (boolean) - Optional. Whether the customer is notified. If `true`, then a notification is sent when the fulfillment is created. The default value is `false`
  * `tracking_info` - Optional.
    * `number` (string) - The tracking number of the fulfillment
    * `url` (string) - The URL to track the fulfillment

Example payload:

```
{
  "fulfillment": {
    "fulfillment_order_id": "00000000-00000000-00000000-00000000",
    "line_items": [
      {
        "id": "00000000-00000000-00000000-00000000",
        "quantity": 5
      }
    ],
    "notify_customer": true,
    "tracking_info": {
      "number": "1234567890",
      "url": "https://www.myshipping.com/track/?tracknumbers=1234567890"
    }
  }
}
```