v1

latestOpenAPI 3.1.02026-07-243113441.2 MB

Employee Benefits

Create year-to-date benefit amounts from a different company

Year-to-date benefit amounts from a different company represents the amount of money added to an employee's plan during a current year, made outside of the current contribution when they were employed at a different company.

This endpoint only supports passing outside contributions for 401(k) benefits.

scope: employee_benefits:write

post/v1/employees/{employee_id}/ytd_benefit_amounts_from_different_company

Path parameters

employee_idstring required

The UUID of the employee

Headers

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

benefit_typeinteger required

The benefit type supported by Gusto.

tax_yearnumber required

The tax year for which this amount applies.

ytd_employee_deduction_amountstring required

The year-to-date employee deduction made outside the current company.

ytd_company_contribution_amountstring required

The year-to-date company contribution made outside the current company.

Response

No Content