orderEditAddCustomItem

mutation

Requires write_order_edits access scope. Also: To use the GraphQL Admin API to edit orders, your app needs to request the write_order_edits access scope for a Shopify store.

Adds a custom line item to an existing order. For example, you could add a gift wrapping service as a custom line item. To learn how to edit existing orders, refer to Edit an existing order with Admin API.

Arguments

Anchor to idid • ID!required: The ID of the calculated order to which the custom item is added.
Anchor to locationIdlocationId • ID: The ID of the retail location (if applicable) from which the custom item is sold. Used for tax calculations. A default location will be chosen automatically if none is provided.
Anchor to priceprice • MoneyInput!required: The unit price of the custom item. This value can't be negative.
Anchor to quantityquantity • Int!required: The quantity of the custom item. This value must be greater than zero.
Anchor to requiresShippingrequiresShipping • Boolean: Whether the custom item requires shipping. Defaults to false.
Anchor to taxabletaxable • Boolean: Whether the custom item is taxable. Defaults to true.
Anchor to titletitle • String!required: The name of the custom item to add.

Was this section helpful?

Anchor to OrderEditAddCustomItemPayload returnsOrderEditAddCustomItemPayload returns

Anchor to calculatedLineItemcalculatedLineItem • CalculatedLineItem: The custom line item that will be added to the order based on the current edits.
Anchor to calculatedOrdercalculatedOrder • CalculatedOrder: An order with the edits applied but not saved.
Anchor to userErrorsuserErrors • [UserError!]!non-null: The list of errors that occurred from executing the mutation.

Was this section helpful?

Mutation Reference

1mutation orderEditAddCustomItem($id: ID!, $locationId: ID, $price: MoneyInput!, $quantity: Int!, $requiresShipping: Boolean, $taxable: Boolean, $title: String!) {
2  orderEditAddCustomItem(id: $id, locationId: $locationId, price: $price, quantity: $quantity, requiresShipping: $requiresShipping, taxable: $taxable, title: $title) {
3    calculatedLineItem {
4      # CalculatedLineItem fields
5    }
6    calculatedOrder {
7      # CalculatedOrder fields
8    }
9    userErrors {
10      field
11      message
12    }
13  }
14}

Input

1{
2  "id": "gid://shopify/<objectName>/10079785100",
3  "locationId": "gid://shopify/<objectName>/10079785100",
4  "price": {
5    "amount": "29.99",
6    "currencyCode": ""
7  },
8  "quantity": 1,
9  "requiresShipping": true,
10  "taxable": true,
11  "title": "<your-title>"
12}

{
  "id": "gid://shopify/<objectName>/10079785100",
  "locationId": "gid://shopify/<objectName>/10079785100",
  "price": {
    "amount": "29.99",
    "currencyCode": ""
  },
  "quantity": 1,
  "requiresShipping": true,
  "taxable": true,
  "title": "<your-title>"
}

input MoneyInput {
  amount: Decimal!
  currencyCode: CurrencyCode!
}