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

# taxIdSave

> Save a tax ID, replacing any saved tax ID with the same `type` and `issuingAuthority`, as editing it on the International returns settings page does. Spaces, dots and dashes are removed from the number, and a number that doesn't fit its type's format fails with `INVALID_TAX_ID`. Returns the saved tax ID with its number masked.

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

**Store must have one of:** `RETURNS`, `PACKAGE_PROTECTION`, `OMS`, `WARRANTIES`, `RECYCLING`, `WITHDRAWALS`

## Arguments

**issuingAuthority** `String!` *required*

Two-letter ISO country code of the country that issued the number, such as GB for a UK EORI.

**nickname** `String`

The store's name for this tax ID. Defaults to the country and type, such as "GB EORI".

**number** `String!` *required*

The tax ID number, such as GB123456789000. It is kept out of the developer log.

**type** `[TaxIdType!](/docs/api-reference/v3/reference/returns/tax-id-type)` *required*

The kind of tax ID.

## Returns

**taxIdSave** `[TaxId!](/docs/api-reference/v3/reference/returns/tax-id)` *required*

A tax ID the store has saved for customs to use on its international return labels. The number is always masked.

**fields**

**id** `ID!` *required*

Pass this to `taxIdDelete` to remove the tax ID.

**issuingAuthority** `String!` *required*

Two-letter ISO country code of the country that issued the number.

**nickname** `String!` *required*

The store's name for this tax ID.

**redactedNumber** `String!` *required*

The number with all but its first and last character masked. The full number is never returned.

**type** `[TaxIdType!](/docs/api-reference/v3/reference/returns/tax-id-type)` *required*

The kind of tax ID.

## Example

```graphql theme={null}
mutation {
  taxIdSave(issuingAuthority: "...", nickname: "...", number: "...", type: BN) {
    id
    issuingAuthority
    nickname
    redactedNumber
    type
  }
}
```


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