Create Purchase order

Creates a new record.

POSThttps://api.tracksales.co/api/v1/purchase-orders

Required scope: purchase_orders:create

Body Params

vendorIdstringrequired

Vendor UUID

itemsarrayrequired

Line items

Responses

201Created

Request succeeded.

401Unauthorized

API key is missing or invalid.

403Forbidden

API key lacks the required scope.

404Not Found

Purchase-orders was not found.

422Validation Error

Request validation failed.

curl -X POST 'https://api.tracksales.co/api/v1/purchase-orders' \
  -H 'Authorization: Bearer ts_live_YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"vendorId":8,"date":"2026-07-01","items":[{"itemId":101,"quantity":10,"unitPrice":800}]}'

{
    "success": true,
    "data": {
        "purchase_order_id": 501,
        "vendorId": 8,
        "total": 8000,
        "status": "open"
    }
}

{
    "success": false,
    "error": {
        "code": "unauthenticated",
        "message": "Invalid or revoked API key."
    }
}

{
    "success": false,
    "error": {
        "code": "forbidden",
        "message": "API key lacks required scope."
    }
}

{
    "success": false,
    "message": "Purchase-orders not found"
}

{
    "success": false,
    "message": "Validation failed",
    "errors": {
        "field": [
            "The field is required."
        ]
    }
}