v1

latestOpenAPI 3.1.02026-07-243113441.2 MB

Pay Schedules

Assign pay schedules for a company

This endpoint assigns employees to pay schedules based on the schedule type. For by_employee and by_department schedules, use the partial_assignment parameter to control the assignment scope. Set it to true for partial assignments (only some employees or departments at a time) and false for full assignments (all employees or departments at once).

scope: pay_schedules:write

post/v1/companies/{company_id}/pay_schedules/assign

Path parameters

company_idstring required

The UUID of the company

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

type'single' | 'hourly_salaried' | 'by_employee' | 'by_department' nullable required

The pay schedule assignment type.

hourly_pay_schedule_uuidstring

Pay schedule for hourly employees.

salaried_pay_schedule_uuidstring

Pay schedule for salaried employees.

default_pay_schedule_uuidstring

Default pay schedule for employees.

partial_assignmentboolean

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.

Response

No Content