Sign in

v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
Departments

Create a department

Create a department

scope: departments:write

post/v1/companies/{company_uuid}/departments

Path parameters

company_uuidstring 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

titlestring required

Name of the department

Example request

{
  "title": "Stage Hand"
}

Response

Created

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