> ## 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.

# internationalCustomsSettingsUpdate

> Change the store's international returns customs settings. Only the fields you supply change. The change is audited as an API edit, as in the app. Turning on `manualReviewOnMissingCustoms` holds international returns that are missing required customs data. Returns the settings after the change.

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

## Arguments

**input** `[InternationalCustomsSettingsInput!](/docs/api-reference/v3/reference/returns/international-customs-settings-input)` *required*

The settings to change.

**fields**

**descriptionsEnabled** `Boolean`

Whether Redo writes a customs description for a product when it has none.

**hsCodesEnabled** `Boolean`

Whether Redo fills in a product's HS code when it has none.

**manualReviewOnMissingCustoms** `Boolean`

Whether to hold an international return whose products lack required customs data for manual review. Turning it on holds every such return from then on.

**shopifyCustomsMetafields** `[ShopifyCustomsMetafieldMappingInput](/docs/api-reference/v3/reference/returns/shopify-customs-metafield-mapping-input)`

The metafield keys to change.

**fields**

**descriptionKey** `String`

Product metafield used as the customs item description on return labels.

**manufacturerKey** `String`

Product metafield used as the manufacturer on the customs form.

**manufacturerPartNumberKey** `String`

Product metafield holding the manufacturer's part number.

**materialKey** `String`

Product metafield appended to the customs description.

**variantDescriptionKey** `String`

Variant metafield used as the customs item description; takes precedence over the product metafield.

**variantManufacturerKey** `String`

Variant metafield used as the manufacturer; takes precedence over the product metafield.

**variantManufacturerPartNumberKey** `String`

Variant metafield holding the manufacturer's part number; takes precedence over the product metafield.

**variantMaterialKey** `String`

Variant metafield appended to the customs description; takes precedence over the product metafield.

## Returns

**internationalCustomsSettingsUpdate** `[InternationalCustomsSettings!](/docs/api-reference/v3/reference/returns/international-customs-settings)` *required*

How the store's international returns get the customs data a carrier needs: which Shopify metafields hold it, what Redo fills in, and what happens to a return that is missing it. These are the settings on the merchant app's International returns page.

**fields**

**descriptionsEnabled** `Boolean!` *required*

Whether Redo writes a customs description for a product when it has none. A value the merchant saved is never replaced. When false, the merchant must supply customs descriptions themselves.

**hsCodesEnabled** `Boolean!` *required*

Whether Redo fills in a product's HS code when it has none. A value the merchant saved is never replaced. When false, the merchant must supply HS codes themselves.

**manualReviewOnMissingCustoms** `Boolean!` *required*

When true, an international return whose products lack required customs data is held for manual review instead of getting a label. Turning it on holds every such return from then on, so returns can wait on the merchant until the data is filled in. When false, Redo buys the label with the data it has.

**shopifyCustomsMetafields** `[ShopifyCustomsMetafieldMapping!](/docs/api-reference/v3/reference/returns/shopify-customs-metafield-mapping)` *required*

Where Redo reads each customs value in Shopify.

**fields**

**descriptionKey** `String`

Product metafield used as the customs item description on return labels.

**manufacturerKey** `String`

Product metafield used as the manufacturer on the customs form.

**manufacturerPartNumberKey** `String`

Product metafield holding the manufacturer's part number, declared to EU customs as the manufacturer Product Identifier.

**materialKey** `String`

Product metafield appended to the customs description.

**variantDescriptionKey** `String`

Variant metafield used as the customs item description; takes precedence over the product metafield.

**variantManufacturerKey** `String`

Variant metafield used as the manufacturer; takes precedence over the product metafield.

**variantManufacturerPartNumberKey** `String`

Variant metafield holding the manufacturer's part number; takes precedence over the product metafield.

**variantMaterialKey** `String`

Variant metafield appended to the customs description; takes precedence over the product metafield.

## Example

```graphql theme={null}
mutation {
  internationalCustomsSettingsUpdate(input: { ... }) {
    descriptionsEnabled
    hsCodesEnabled
    manualReviewOnMissingCustoms
  }
}
```


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