GuidesAPI ReferenceChangelogAPI StatusAPI PolicyGusto Security
API Reference

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

post
https://api.gusto-demo.com/v1/employees//ytd_benefit_amounts_from_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

Path Params
string
required

The UUID of the employee

Body Params
integer

The benefit type supported by Gusto.

number
required
2000 to 2999

The tax year for which this amount applies.

string
required
Defaults to 0.00

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

string
required
Defaults to 0.00

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

Headers
string
enum
Defaults to 2026-02-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
204

No Content

404

Not Found

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

Updated 4 months ago

Language
Credentials
Bearer
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated 4 months ago