v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
Departments

Add people to a department

Add employees and contractors to a department

scope: departments:write

put/v1/departments/{department_uuid}/add

Path parameters

department_uuidstring required

The UUID of the department

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

versionstring required

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

Example request

{
  "version": "56d00c178bc7393b2a206ed6a86afcb4"
}

Response

Success

versionstring

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

uuidstring

The UUID of the department

company_uuidstring

The UUID of the company

titlestring

Name of the department