API version: unstable
API version: 2021-07 Release candidate
API version: 2021-04 Latest
API version: 2021-01
API version: 2020-10
API version: 2020-07
API version: 2020-04 Unsupported
API version: 2020-01 Unsupported

orderEditAddCustomItem mutation

Version unstable

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

Required access

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.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
id ( ID! ) required

The ID of the calculated order to add an item to.

locationId ( ID )

The ID of the location that this item will be fulfilled from. A default will be chosen automatically if none is provided.

price ( MoneyInput! ) required

The price of the custom item to add. It cannot be negative.

quantity ( Int! ) required

The quantity of the custom item to add. It must be greater than zero.

requiresShipping ( Boolean )

Whether the item requires shipping. Default is false.

taxable ( Boolean )

Whether the item is taxable. Default is true.

title ( String! ) required

The name of the custom item to add.

MoneyInput fields

  • amount (Decimal!) Required

    Decimal money amount.

  • currencyCode (CurrencyCode!) Required

    Currency of the money.

Return fields

Version 2021-07 (Release candidate)

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

Required access

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.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
id ( ID! ) required

The ID of the calculated order to add an item to.

locationId ( ID )

The ID of the location that this item will be fulfilled from. A default will be chosen automatically if none is provided.

price ( MoneyInput! ) required

The price of the custom item to add. It cannot be negative.

quantity ( Int! ) required

The quantity of the custom item to add. It must be greater than zero.

requiresShipping ( Boolean )

Whether the item requires shipping. Default is false.

taxable ( Boolean )

Whether the item is taxable. Default is true.

title ( String! ) required

The name of the custom item to add.

MoneyInput fields

  • amount (Decimal!) Required

    Decimal money amount.

  • currencyCode (CurrencyCode!) Required

    Currency of the money.

Return fields

Version 2021-04 (Latest)

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

Required access

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.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
id ( ID! ) required

The ID of the calculated order to add an item to.

locationId ( ID )

The ID of the location that this item will be fulfilled from. A default will be chosen automatically if none is provided.

price ( MoneyInput! ) required

The price of the custom item to add. It cannot be negative.

quantity ( Int! ) required

The quantity of the custom item to add. It must be greater than zero.

requiresShipping ( Boolean )

Whether the item requires shipping. Default is false.

taxable ( Boolean )

Whether the item is taxable. Default is true.

title ( String! ) required

The name of the custom item to add.

MoneyInput fields

  • amount (Decimal!) Required

    Decimal money amount.

  • currencyCode (CurrencyCode!) Required

    Currency of the money.

Return fields

Version 2021-01

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

Required access

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.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
id ( ID! ) required

The ID of the calculated order to add an item to.

locationId ( ID )

The ID of the location that this item will be fulfilled from. A default will be chosen automatically if none is provided.

price ( MoneyInput! ) required

The price of the custom item to add. It cannot be negative.

quantity ( Int! ) required

The quantity of the custom item to add. It must be greater than zero.

requiresShipping ( Boolean )

Whether the item requires shipping. Default is false.

taxable ( Boolean )

Whether the item is taxable. Default is true.

title ( String! ) required

The name of the custom item to add.

MoneyInput fields

  • amount (Decimal!) Required

    Decimal money amount.

  • currencyCode (CurrencyCode!) Required

    Currency of the money.

Return fields

Version 2020-10

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

Required access

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.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
id ( ID! ) required

The ID of the calculated order to add an item to.

locationId ( ID )

The ID of the location that this item will be fulfilled from. A default will be chosen automatically if none is provided.

price ( MoneyInput! ) required

The price of the custom item to add. It cannot be negative.

quantity ( Int! ) required

The quantity of the custom item to add. It must be greater than zero.

requiresShipping ( Boolean )

Whether the item requires shipping. Default is false.

taxable ( Boolean )

Whether the item is taxable. Default is true.

title ( String! ) required

The name of the custom item to add.

MoneyInput fields

  • amount (Decimal!) Required

    Decimal money amount.

  • currencyCode (CurrencyCode!) Required

    Currency of the money.

Return fields

Version 2020-07

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

Required access

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.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
id ( ID! ) required

The ID of the calculated order to add an item to.

locationId ( ID )

The ID of the location that this item will be fulfilled from. A default will be chosen automatically if none is provided.

price ( MoneyInput! ) required

The price of the custom item to add. It cannot be negative.

quantity ( Int! ) required

The quantity of the custom item to add. It must be greater than zero.

requiresShipping ( Boolean )

Whether the item requires shipping. Default is false.

taxable ( Boolean )

Whether the item is taxable. Default is true.

title ( String! ) required

The name of the custom item to add.

MoneyInput fields

  • amount (Decimal!) Required

    Decimal money amount.

  • currencyCode (CurrencyCode!) Required

    Currency of the money.

Return fields

Version 2020-04 (Unsupported)

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

Required access

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.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
id ( ID! ) required

The ID of the calculated order to add an item to.

locationId ( ID )

The ID of the location that this item will be fulfilled from. A default will be chosen automatically if none is provided.

price ( MoneyInput! ) required

The price of the custom item to add. It cannot be negative.

quantity ( Int! ) required

The quantity of the custom item to add. It must be greater than zero.

requiresShipping ( Boolean )

Whether the item requires shipping. Default is false.

taxable ( Boolean )

Whether the item is taxable. Default is true.

title ( String! ) required

The name of the custom item to add.

MoneyInput fields

  • amount (Decimal!) Required

    Decimal money amount.

  • currencyCode (CurrencyCode!) Required

    Currency of the money.

Return fields

Version 2020-01 (Unsupported)

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

Required access

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.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
id ( ID! ) required

The ID of the calculated order to add an item to.

locationId ( ID )

The ID of the location that this item will be fulfilled from. A default will be chosen automatically if none is provided.

price ( MoneyInput! ) required

The price of the custom item to add. It cannot be negative.

quantity ( Int! ) required

The quantity of the custom item to add. It must be greater than zero.

requiresShipping ( Boolean )

Whether the item requires shipping. Default is false.

taxable ( Boolean )

Whether the item is taxable. Default is true.

title ( String! ) required

The name of the custom item to add.

MoneyInput fields

  • amount (Decimal!) Required

    Decimal money amount.

  • currencyCode (CurrencyCode!) Required

    Currency of the money.

Return fields

Version 2019-10 (Unsupported)

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

Required access

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.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
id ( ID! ) required

The ID of the calculated order to add an item to.

locationId ( ID )

The ID of the location that this item will be fulfilled from. A default will be chosen automatically if none is provided.

price ( MoneyInput! ) required

The price of the custom item to add. It cannot be negative.

quantity ( Int! ) required

The quantity of the custom item to add. It must be greater than zero.

requiresShipping ( Boolean )

Whether the item requires shipping. Default is false.

taxable ( Boolean )

Whether the item is taxable. Default is true.

title ( String! ) required

The name of the custom item to add.

MoneyInput fields

  • amount (Decimal!) Required

    Decimal money amount.

  • currencyCode (CurrencyCode!) Required

    Currency of the money.

Return fields

Version 2019-07 (Unsupported)

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

Required access

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.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
id ( ID! ) required

The ID of the calculated order to add an item to.

locationId ( ID )

The ID of the location that this item will be fulfilled from. A default will be chosen automatically if none is provided.

price ( MoneyInput! ) required

The price of the custom item to add. It cannot be negative.

quantity ( Int! ) required

The quantity of the custom item to add. It must be greater than zero.

requiresShipping ( Boolean )

Whether the item requires shipping. Default is false.

taxable ( Boolean )

Whether the item is taxable. Default is true.

title ( String! ) required

The name of the custom item to add.

MoneyInput fields

  • amount (Decimal!) Required

    Decimal money amount.

  • currencyCode (CurrencyCode!) Required

    Currency of the money.

Return fields

Version 2019-04 (Unsupported)

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

Required access

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.

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

Argument Description
id ( ID! ) required

The ID of the calculated order to add an item to.

locationId ( ID )

The ID of the location that this item will be fulfilled from. A default will be chosen automatically if none is provided.

price ( MoneyInput! ) required

The price of the custom item to add. It cannot be negative.

quantity ( Int! ) required

The quantity of the custom item to add. It must be greater than zero.

requiresShipping ( Boolean )

Whether the item requires shipping. Default is false.

taxable ( Boolean )

Whether the item is taxable. Default is true.

title ( String! ) required

The name of the custom item to add.

MoneyInput fields

  • amount (Decimal!) Required

    Decimal money amount.

  • currencyCode (CurrencyCode!) Required

    Currency of the money.

Return fields