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

# returnShippingOptionsUpdate

> Change the store's return shipping options. Only the fields you supply change. The change is audited as an API edit, as in the app. These settings change what return labels cost the store and what customers are paid: a higher `merchantMaxLabelPrice` raises label spend, a signature requirement makes labels cost more, and the `deductLabelFrom...` flags reduce refunds, store credit and exchange value. Returns the options after the change.

**Required scopes:** [`returns_write`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-returns_write)

## Arguments

**input** `[ReturnShippingOptionsInput!](/docs/api-reference/v3/reference/returns/return-shipping-options-input)` *required*

The options to change.

**fields**

**deductLabelFromCredit** `Boolean`

Whether to subtract the return label's cost from the customer's store credit. Changes what customers are paid out.

**deductLabelFromExchange** `Boolean`

Whether to subtract the return label's cost from the value applied to an exchange.

**deductLabelFromRefund** `Boolean`

Whether to subtract the return label's cost from the customer's refund. Changes what customers are paid out.

**merchantMaxLabelPrice** `[MoneyInput](/docs/api-reference/v3/reference/common/money-input)`

The most Redo will pay for one return label when the store pays for it. USD, from 1 to 2000. Null clears it, so Redo's default cap applies. Raising it raises what a label can cost the store.

**fields**

**amount** `[Decimal!](/docs/api-reference/v3/reference/common/decimal)` *required*

The amount as an exact decimal string (e.g. "19.99").

**currency** `String!` *required*

ISO 4217 currency code (e.g. USD).

**onlyCombineLabelsFromSameFulfillment** `Boolean`

Whether items share one return label only when they shipped in the same original fulfillment.

**requireSignature** `Boolean`

Whether to require a signature when the returned items are worth at least `requireSignatureThreshold`. Signature delivery costs more per label.

**requireSignatureForTags** `Boolean`

Whether to require a signature when a return contains a product with one of `requireSignatureTags`. Signature delivery costs more per label.

**requireSignatureTags** `[String!]`

Product tags that require a signature, replacing the current list. Blank tags are dropped. An empty list clears it.

**requireSignatureThreshold** `[MoneyInput](/docs/api-reference/v3/reference/common/money-input)`

The total value at or above which a signature is required. USD, 0 or more. Null clears it, so no value triggers it.

**fields**

**amount** `[Decimal!](/docs/api-reference/v3/reference/common/decimal)` *required*

The amount as an exact decimal string (e.g. "19.99").

**currency** `String!` *required*

ISO 4217 currency code (e.g. USD).

## Returns

**returnShippingOptionsUpdate** `[ReturnShippingOptions!](/docs/api-reference/v3/reference/returns/return-shipping-options)` *required*

How the store buys and charges for return shipping labels: the most it will pay for one, when a signature is required, what a label's cost is deducted from, and how items share a label. These are the settings on the merchant app's shipping and returns pages. Several of them change what a label costs the store or what a customer is paid.

**fields**

**deductLabelFromCredit** `Boolean!` *required*

Whether the cost of the return label is subtracted from the store credit the customer receives. Changes what customers are paid out.

**deductLabelFromExchange** `Boolean!` *required*

Whether the cost of the return label is subtracted from the value applied to an exchange.

**deductLabelFromRefund** `Boolean!` *required*

Whether the cost of the return label is subtracted from the customer's refund. Changes what customers are paid out.

**merchantMaxLabelPrice** `[Money](/docs/api-reference/v3/reference/common/money)`

The most Redo will pay for one return label when the store is the one paying for it. Null means Redo's default cap applies. Customer-paid and Redo-paid labels have their own caps, so this does not affect them. Always in USD.

**fields**

**amount** `[Decimal!](/docs/api-reference/v3/reference/common/decimal)` *required*

The exact amount as a decimal string (e.g. "19.99").

**currency** `String!` *required*

ISO 4217 currency code (e.g. USD).

**onlyCombineLabelsFromSameFulfillment** `Boolean!` *required*

Whether items share one return label only when they shipped in the same original fulfillment. When false, items from different fulfillments can share a label, which costs less but mixes shipments.

**requireSignature** `Boolean!` *required*

Whether a return shipment needs a signature on delivery when the returned items are worth at least `requireSignatureThreshold`. Signature delivery costs more per label. Has no effect while the threshold is null.

**requireSignatureForTags** `Boolean!` *required*

Whether a return shipment needs a signature on delivery when it contains a product with one of `requireSignatureTags`. Signature delivery costs more per label.

**requireSignatureTags** `[String!]!` *required*

Product tags that require a signature when `requireSignatureForTags` is on. Matched without regard to case.

**requireSignatureThreshold** `[Money](/docs/api-reference/v3/reference/common/money)`

The returned items' total value at or above which a signature is required, when `requireSignature` is on. Null means no value triggers it. Always in USD.

**fields**

**amount** `[Decimal!](/docs/api-reference/v3/reference/common/decimal)` *required*

The exact amount as a decimal string (e.g. "19.99").

**currency** `String!` *required*

ISO 4217 currency code (e.g. USD).

## Example

```graphql theme={null}
mutation {
  returnShippingOptionsUpdate(input: { ... }) {
    deductLabelFromCredit
    deductLabelFromExchange
    deductLabelFromRefund
    onlyCombineLabelsFromSameFulfillment
    requireSignature
    requireSignatureForTags
    requireSignatureTags
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.