Update Federal Tax Details

put

https://api.gusto-demo.com/v1/companies/{company_id}/federal_tax_details

Updates attributes relevant for a company's federal taxes.
This information is required is to onboard a company for use with Gusto Embedded Payroll.

scope: company_federal_taxes:write

Path Params

company_id

string

required

The UUID of the company

Body Params

Attributes related to federal tax details that can be updated via this endpoint include:

legal_name

string

The legal name of the company

ein

string

The EIN of of the company

tax_payer_type

string

enum

What type of tax entity the company is

filing_form

string

enum

The form used by the company for federal tax filing. One of:

Allowed:

taxable_as_scorp

boolean

Whether this company should be taxed as an S-Corporation

version

string

required

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

Headers

X-Gusto-API-Version

string

enum

Defaults to 2024-03-01

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

Allowed:

Responses

404

Not Found

The requested resource does not exist. Make sure the provided UUID is valid.

200Example response