GuidesAPI ReferenceChangelogAPI StatusAPI PolicyGusto Security
API Reference

Create a company benefit

post
https://api.gusto-demo.com/v1/companies//company_benefits

Company benefits represent the benefits that a company is offering to employees. This ties together a particular supported benefit with the company-specific information for the offering of that benefit.

Note that company benefits can be deactivated only when no employees are enrolled.

When the application has the company_benefits:write:benefit_type_limited data scope, the application can only create company benefits for benefit types that are permitted for the application.

scope: company_benefits:write

Path Params
string
required

The UUID of the company

Body Params
integer

The ID of the benefit to which the company benefit belongs.

boolean
Defaults to true

Whether this benefit is active for employee participation.

string
required

The description of the company benefit.For example, a company may offer multiple benefits with an ID of 1 (for Medical Insurance). The description would show something more specific like "Kaiser Permanente" or "Blue Cross/ Blue Shield".

boolean

Whether the employer is subject to pay employer taxes when an employee is on leave. Only applicable to third party sick pay benefits.

boolean

Whether the employer is subject to file W-2 forms for an employee on leave. Only applicable to third party sick pay benefits.

enum

The type of catch-up contribution for this benefit, as required by Section 603 of the SECURE 2.0 Act. Only applicable to pre-tax 401(k) and 403(b) benefits.

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

Updated 5 months ago

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

Updated 5 months ago