Preview pay schedule assignments for a company

post

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

This endpoint returns the employee changes, including pay period and transition pay periods, for changing the pay schedule.

scope: pay_schedules:write

Path Params

company_id

string

required

The UUID of the company

Body Params

type

enum

required

The pay schedule assignment type.

hourly_pay_schedule_uuid

string

Pay schedule for hourly employees.

salaried_pay_schedule_uuid

string

Pay schedule for salaried employees.

default_pay_schedule_uuid

string

Default pay schedule for employees.

partial_assignment

boolean

Indicates whether the request provides pay schedule assignments for a partial list of employees or departments of the company. By default, this is set to false.

employees

array of objects

List of employees and their pay schedules.

employees

departments

array of objects

List of departments and their pay schedules.

departments

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

404

Not Found

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

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Example response

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.