---
title: "Update a company's federal tax details"
method: PUT
path: "/v1/companies/{company_id}/federal_tax_details"
tags: ["Federal Tax Details"]
---

# Update a company's federal tax details

`PUT /v1/companies/{company_id}/federal_tax_details`

Updates a company's federal tax details including EIN, legal name, tax payer type, filing form, and S-Corp
taxation status. This information is required to onboard a company for use with Gusto Embedded Payroll.

### Prerequisites
Before calling this endpoint, retrieve the current federal tax details and `version` via [GET /v1/companies/{company_id}/federal_tax_details](https://docs.gusto.com/embedded-payroll/reference/get-v1-companies-company_id-federal_tax_details)

### Webhooks
- `company.updated`: Fires when federal tax details for a company are successfully updated

**Setup:** [POST /v1/webhook_subscriptions](https://docs.gusto.com/embedded-payroll/reference/post-v1-webhook-subscription) with `subscription_types`: `["Company"]`

scope: `company_federal_taxes:write`

## Path parameters

- `company_id` string, required

## Headers

- `X-Gusto-API-Version` '2026-06-15'

## Request body

- FederalTaxDetailsUpdate
  - `version` string, required — The current version of the object. See the [versioning guide](https://docs.gusto.com/embedded-payroll/docs/idempotency) for information on how to use this field.
  - `legal_name` string — The legal name of the company
  - `ein` string — The company's Employer Identification Number (EIN). Must be 9 digits. Dashes are optional (e.g., '12-3456789' or '123456789').
  - `tax_payer_type` 'C-Corporation' | 'S-Corporation' | 'Sole proprietor' | 'LLC' | 'LLP' | 'Limited partnership' | 'Co-ownership' | 'Association' | 'Trusteeship' | 'General partnership' | 'Joint venture' | 'Non-Profit' — What type of tax entity the company is. One of: - C-Corporation - S-Corporation - Sole proprietor - LLC - LLP - Limited partnership - Co-ownership - Association - Trusteeship - General partnership - Joint venture - Non-Profit
  - `filing_form` '941' | '944' — The form used by the company for federal tax filing. One of: - 941 (Quarterly federal tax return form) - 944 (Annual federal tax return form)
  - `taxable_as_scorp` boolean — Whether the company is taxed as an S-Corporation

## Response `200`

Success

- FederalTaxDetails
  - `version` string — The current version of the object. See the [versioning guide](https://docs.gusto.com/embedded-payroll/docs/idempotency) for information on how to use this field.
  - `tax_payer_type` 'C-Corporation' | 'S-Corporation' | 'Sole proprietor' | 'LLC' | 'LLP' | 'Limited partnership' | 'Co-ownership' | 'Association' | 'Trusteeship' | 'General partnership' | 'Joint venture' | 'Non-Profit', nullable — What type of tax entity the company is. One of: - C-Corporation - S-Corporation - Sole proprietor - LLC - LLP - Limited partnership - Co-ownership - Association - Trusteeship - General partnership - Joint venture - Non-Profit
  - `taxable_as_scorp` boolean — Whether the company is taxed as an S-Corporation. Tax payer types that may be taxed as an S-Corporation include: - S-Corporation - C-Corporation - LLC
  - `filing_form` '941' | '944' — The form used by the company for federal tax filing. One of: - 941 (Quarterly federal tax return form) - 944 (Annual federal tax return form)
  - `has_ein` boolean — Whether company's Employer Identification Number (EIN) is present
  - `ein_verified` boolean — Whether the EIN has been successfully verified as a valid EIN with the IRS.
  - `ein_verification` object — Information about the status of verifying the company's Employer Identification Number (EIN)
    - `status` 'pending' | 'verified' | 'failed' — The status of EIN verification: - `pending`: The EIN verification process has not completed (or the company does not yet have an EIN). - `verified`: The EIN has been successfully verified as a valid EIN with the IRS. - `failed`: The company's EIN did not pass verification. Common issues are being entered incorrectly or not matching the company's legal name.
  - `legal_name` string — The legal name of the company
  - `effective_date` string — The date that these details took effect.
  - `deposit_schedule` string — How often the company sends money to the IRS. One of: - Semiweekly - Monthly

## Other responses

- `403` — Forbidden
- `404` — Not Found The requested resource does not exist. Make sure the provided UUID is valid.
- `409` — Conflict
- `422` — Unprocessable Entity This may happen when the body of your request contains errors such as `invalid_attribute_value`, or the request fails due to an `invalid_operation`. See the [Errors Categories](https://docs.gusto.com/embedded-payroll/docs/error-categories) guide for more details.

---

[API](https://skmtc.net/gusto/apis/gusto-api.md) · [All operations](https://skmtc.net/gusto/apis/gusto-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gusto/gusto-api/revisions/826dfa57fb3b/schema)