Create a department

Before using this guide you must have a , created an and have a company. To learn more about these steps, review the guide.

Departments can be used for employers to understand, organize and report on their employees.

1. Create a department

To create a department, use the POST companies/{company_uuid}/departments endpoint.

bash

curl --request POST \
     --url https://api.gusto-demo.com/v1/companies/{company_uuid}/departments \
     --header 'accept: application/json' \
     --header 'authorization: Bearer <<COMPANY_ACCESS_TOKEN>>' \
     --header 'content-type: application/json' \
     --data '
{
     "title": "Stage Hand"
}
'

2. Add employees and/or contractors to the department

Use the PUT departments/{department_uuid}/add endpoint to add employees and contractors to a department.

bash

curl --request PUT \
     --url https://api.gusto-demo.com/v1/departments/{department_uuid}/add \
     --header 'accept: application/json' \
     --header 'authorization: Bearer <<COMPANY_ACCESS_TOKEN>>' \
     --header 'content-type: application/json' \
     --data '
{
     "employees": [
          {
               "uuid": "41199375-a999-4414-9f40-d9bf596b134d"
          }
     ],
     "contractors": [
          {
               "uuid": "3488549f-60e4-494f-a34a-9d8aad3aabf5"
          }
     ],
     "version": "1fe3076d35ef7c97d0ae68c5f4df0acd"
}
'

To remove people from a department you can use the PUT departments/department_uuid/remove endpoint.

---

Manage company attachments

Calculate an invoice