Sales & CRMMu Mutation

upsertPurchaseOrder

Topics: Commerce

Create or update a purchase order. Requires purchaseOrder:write permission.

Returns

UpsertPurchaseOrderPayload!

Arguments

Purchase order data

Examples

Create Commerce Purchase Order

mutation CreateCommercePurchaseOrder($input: UpsertPurchaseOrderInput!) {
  upsertPurchaseOrder(input: $input) {
    purchaseOrder { id poNumber status totalAmount currency }
    errors { path message }
  }
}

Variables

{
  "input": {
    "poNumber": "PO-2042",
    "supplierId": "sup_01h455vb4pex5vsknk084sn02q",
    "orderDate": "2026-10-21T09:00:00.000Z",
    "totalAmount": 500,
    "currency": "EUR"
  }
}
Exact field SDL
"""
Create or update a purchase order. Requires purchaseOrder:write permission.
"""
upsertPurchaseOrder(
  """Purchase order data"""
  input: UpsertPurchaseOrderInput!
): UpsertPurchaseOrderPayload! @topic(names: ["commerce"]) @topic_example(names: ["commerce.create-purchase-order"])

Declared on Mutation. Access is checked by the platform for each operation.