Employee : Assign to Department

Departments are a type of Account, and employees can be assigned to them using the action "assign-to-site". A Site is a type of account, and Departments are another, so the action is re-usable for this additional context.

Assigning an Employee to a Department

Given a /departments record who’s id is 532, and an employee who’s id is 1442:

[POST] /employees/1442/actions/assign-to-site
With payload:

{
   "account": 532,
   "startDate": "2026-04-07",
   "isPrimary": false
}

View the List of Employees Assigned to a Department

As a results check of the previous step, or as a lookup in general, you can view the list of employees assigned to a Department using the /departments endpoint and the ID of a Department:

[GET] /departments/532?include=employeeAssignments,employeeAssignments.employee.name

Result:

{
       "name": "BYOD Officer Devices - Mobile",
       "details": "",
       "customId": "532",
       "region": 7,
       "status": "ACTIVE",
       "installCode": "D532L28D",
       "taxLocation": null,
       "id": 532,
       "employeeAssignments": [
           {
               "account": 532,
               "active": true,
               "payRate": null,
               "startedOn": "2026-04-01T00:00:00+00:00",
               "startDate": "2026-04-01T00:00:00+00:00",
               "endedOn": null,
               "endDate": null,
               "effectiveOn": null,
               "currentEffectivePaySettingId": null,
               "id": 4553,
               "employee": {
                   "jobTitle": "",
                   "region": 2,
                   "employmentProfile": 360,
                   "address": 1638,
                   "id": 1442,
                   "customId": "",
                   "firstName": "Ariella",
                   "middleName": "",
                   "lastName": "test",
                   "name": "Ariella test",
                   "primaryPhone": "",
                   "secondaryPhone": "",
                   "email": "",
                   "status": "ACTIVE"
               }
           }
       ]
   }