Update Taxpayer Identification Number (TIN) 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"
    }
  }
}