Office Hours

Office hours record the days an employee normally works and the times on each day. They are guidance for the people (and agents) planning work — nothing is blocked or clocked automatically.

Where to set them

Two places, and both write to the same record:

• HR → Employees → edit an employee → Office Hours — for admins and anyone whose Edit Employees permission covers that person.
• Profile Settings → Profile → Office Hours — how an employee sets their own.

Turning them on

1. Switch Office Hours on. The panel appears.
2. Pick a Timezone, or leave it on Company timezone. The hours below are read in this timezone, so an employee in another region does not have to convert them by hand.
3. Switch on each day the person works. A day left off shows as Not a working day.
4. Enter a Start and End time for the day.

More than one time on a day

A split day is normal — mornings on one thing, afternoons on another. Click Add another time on that day and enter the second range, for example:

Use the × beside a range to remove it. Removing the only range on a day empties it rather than deleting the row, so you can retype it.

Apply to all days

Set one day the way you want it, then click Apply to all days on that day. Its ranges are copied to every day that is switched on — days that are off stay off, so you do not have to undo weekends afterwards.

What is saved

Only complete, sensible ranges are stored: a half-filled range, or one that ends before it starts, is dropped instead of being saved as something the rest of the app has to interpret.

The result is shown on the employee's profile, under their timezone.

Over the API

The employee's own timezone is on employee_detail.timezone (null means the company timezone), and the week is available on the Employees resource:

GET /api/v1/employee/{id}?fields=office_hours

Each row is one range on one day, where day is 0 = Sunday … 6 = Saturday. A day with no rows is not a working day.