> ## Documentation Index
> Fetch the complete documentation index at: https://developer.worldly.io/llms.txt
> Use this file to discover all available pages before exploring further.

# PIC - Create a Purchase Order

> This recipe shows you how to add a Purchase Order to a product in PIC.

```bash theme={null}
curl --request POST \
     --url https://api-v2.production.higg.org/pic-api/v1/purchase-orders/create \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: <<apiKey>>' \
     --header 'x-developer-request-token: <<apiKey>>' \
		 --data '{
  			"productId": "string",
  			"purchaseOrder": {
    		"purchaseOrderId": "123-DISCO",
    		"purchaseDate": "2025-10-11",
    		"amountPurchase": 1000
  			}
			}'
```

```json theme={null}
{"success":true}
```

<Steps>
  <Step title="Set Product ID">
    ### field: productId

    Field type: string

    Include the Product ID of the product you want to update.

    *Example:*

    `12abc123456789101de12345`

    ```json theme={null}
    "productId": "string",
    ```
  </Step>

  <Step title="Include Purchase Order object">
    The `purchaseOrder` object wraps the PO fields below.

    ```json theme={null}
    "purchaseOrder": {
        "purchaseOrderId": "123-DISCO",
        "purchaseDate": "2025-10-11",
        "amountPurchase": 1000
    }
    ```
  </Step>

  <Step title="Set PO ID">
    ### field: purchaseOrderId

    Field type: string

    This field is *optional*.

    ```json theme={null}
    "purchaseOrderId": "123-DISCO",
    ```
  </Step>

  <Step title="Set PO Date">
    ### field: purchaseDate

    Field type: string

    Use format: `YYYY-MM-DD`

    ```json theme={null}
    "purchaseDate": "2025-10-11",
    ```
  </Step>

  <Step title="Set Quantity Purchased">
    ### field: amountPurchase

    Field type: double

    ```json theme={null}
    "amountPurchase": 1000
    ```
  </Step>
</Steps>