Update a company's 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

Webhooks

company.updated: Fires when federal tax details for a company are successfully updated

Setup: POST /v1/webhook_subscriptions with subscription_types: ["Company"]

scope: company_federal_taxes:write

company_idstring required

The UUID of the company

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

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Request body

versionstring required

The current version of the object. See the versioning guide for information on how to use this field.

legal_namestring

The legal name of the company

einstring

The company's Employer Identification Number (EIN). Must be 9 digits. Dashes are optional (e.g., '12-3456789' or '123456789').

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_scorpboolean

Whether the company is taxed as an S-Corporation

Example request

{
  "version": "6cb95e00540706ca48d4577b3c839fbe",
  "legal_name": "Acme Corp.",
  "ein": "123456789",
  "tax_payer_type": "LLP",
  "filing_form": "944"
}

Response

Success

versionstring

The current version of the object. See the versioning guide for information on how to use this field.

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_scorpboolean

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_einboolean

Whether company's Employer Identification Number (EIN) is present

ein_verifiedboolean

Whether the EIN has been successfully verified as a valid EIN with the IRS.

legal_namestring

The legal name of the company

effective_datestring

The date that these details took effect.

deposit_schedulestring

How often the company sends money to the IRS. One of:

Semiweekly
Monthly

v1