Update a company benefit

put

https://api.gusto-demo.com/v1/company_benefits/{company_benefit_id}

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 update company benefits for benefit types that are permitted for the application.

scope: company_benefits:write

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

company_benefit_id

string

required

The UUID of the company benefit

Body Params

version

string

required

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

active

boolean

Whether this benefit is active for employee participation. Company benefits may only be deactivated if no employees are actively participating.

description

string

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".

responsible_for_employer_taxes

boolean

Whether the employer is subject to pay employer taxes when an employee is on leave. Only applicable to short-term and long-term disability benefits (different from voluntary disability).

responsible_for_employee_w2

boolean

Whether the employer is subject to file W-2 forms for an employee on leave. Only applicable to short-term and long-term disability benefits (different from voluntary disability).

catch_up_type

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

X-Gusto-API-Version

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

200Success

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

422Unprocessable Entity This may happen when the body of your request contains errors such as invalid_attribute_value, or the request fails due to an invalid_operation. See the Errors Categories guide for more details.