# Update Taxpayer Identification Number (TIN) for a company

Source: https://developer.avalara.com/products/returns/integration-guides/managed-returns/gfu7922187699124/

Guide: Avalara Managed Returns API (U.S. and Canada)

# Update Taxpayer Identification Number (TIN) for a company

Learn how to update the Taxpayer Identification Number (TIN), also known as Employer Identification Number (EIN), for a company.

The Taxpayer Identification Number (TIN), also known as Employer Identification Number (EIN) is used to identify the company for tax filing purposes in the United States.

Notice

When you update the company-level TIN, this change only affects returns moving forward. Existing filing calendars will retain their current TIN and must be updated individually if needed.

To update the TIN for a company, use the `updateCompany` mutation with the `taxpayerIdNumber` field.

## View request

```
mutation updateCompanyTIN {
  updateCompany(
    id: 11111
    input: {
      id: 11111
      name: "CRR Onboarding Test 44"
      taxpayerIdNumber: "12-3456789"
    }
  ) {
    id
    name
    taxpayerIdNumber
    filingStatus
  }
}
```

## View response

```
{
  "data": {
    "updateCompany": {
      "id": 11111,
      "name": "CRR Onboarding Test 44",
      "taxpayerIdNumber": "12-3456789",
      "filingStatus": "ACTIVE"
    }
  }
}
```

## Valid TIN formats

The `taxpayerIdNumber` field accepts the following formats (all formats must contain exactly 9 digits):

-   `123456789` - 9 digits, no dashes

-   `12-3456789` - XX-XXXXXXX format

-   `123-456-789` - XXX-XXX-XXX format

-   `123-45-6789` - XXX-XX-XXXX format

```
# Format 1: No dashes
taxpayerIdNumber: "123456789"
# Format 2: XX-XXXXXXX
taxpayerIdNumber: "12-3456789"
# Format 3: XXX-XXX-XXX
taxpayerIdNumber: "123-456-789"
# Format 4: XXX-XX-XXXX
taxpayerIdNumber: "123-45-6789"
```

Note

-   **Forward-only updates:** When you update a company's TIN, the change applies only to new filing calendars created after the update. Existing filing calendars retain their original EIN values.

-   **Individual calendar updates:** If you need to update the TIN on existing filing calendars, you must update each filing calendar individually.

-   **Optional field:** The `taxpayerIdNumber` field is optional. You can update other company fields (such as `name` or `status`) without providing a TIN value.

-   **Format validation:** The system validates that the TIN follows one of the accepted formats. Invalid formats will result in an error.

## Update filing status and TIN for a company

You can update both the filing status and TIN using the `updateCompany` mutation.

## View request

```
mutation updateCompanyStatusAndTIN {
  updateCompany(
    id: 11111
    input: {
      id: 11111
      name: "CRR Onboarding Test 44"
      status: ACTIVE
      taxpayerIdNumber: "123-45-6789"
    }
  ) {
    id
    name
    taxpayerIdNumber
    filingStatus
  }
}
```

## View response

```
{
  "data": {
    "updateCompany": {
      "id": 11111,
      "name": "CRR Onboarding Test 44",
      "taxpayerIdNumber": "123-45-6789",
      "filingStatus": "ACTIVE"
    }
  }
}
```