Roles & Permissions

The four BookYourPTO roles — Employee, Department Head, Administrator, Executive — what each can do, how leave approval follows the role, and department scoping.

Roles & Permissions

Every user in BookYourPTO has exactly one role that determines what they can see and do. Department scoping refines it for department heads. This page explains both so admins can assign access correctly and users understand what they're allowed to do.

The server is authoritative. Every permission shown in the UI is re-checked and enforced on the backend. Hiding a button is a convenience, not a security boundary — the API rejects an action the caller isn't entitled to.

The four roles

RoleIn one line
EmployeeManages their own leave, time, and expenses.
Department HeadAn employee who can also approve and manage their own department.
AdministratorManages the whole organization except executive-exclusive actions.
ExecutiveEverything an admin can, plus security/branding settings, SSO, and org deletion.

Employee

  • Create and manage their own leave, time entries, and expenses.
  • View their own data and edit personal settings (password, two-factor, profile).
  • Cannot cancel their own approved leave — they must submit a cancellation request for an approver to action.

Department Head

Everything an employee can, scoped to their own department, plus:

  • View users.
  • Approve / reject / cancel leave, expenses, and time for users in their department.
  • Create leave for themselves and same-department users.
  • Author employee notes and see the Performance tab.
  • Set up and change 1:1 series for people in their department.
  • See clock-in locations for people in their department.
  • Send documents for signature to people in their department (see below).

A department head cannot:

  • Approve their own requests.
  • Edit compensation (admin/executive only).
  • Create administrators or executives.
  • Publish schedules or override pay-period lockdown.
  • Open documents that HR or an administrator sent to people in their department.

Department heads and documents

A department head works with the documents they sent and with their own:

ActionDocuments they sent to people in their departmentTheir own documentsDocuments HR or an administrator sent to their department
View and downloadYesYesNo
Audit trailYesYesNo
Rename or moveYesOnly ones they uploadedNo
DeleteYesOnly ones they uploaded, with no pending signaturesNo

A department head cannot add themselves as a signer on a document they send. Administrators and executives can act on every document in the organization. See Documents.

Administrator

  • Manage users, departments, leave types, org settings, reporting structure, group bookings, and locked dates.
  • Approve / cancel any leave (not just one department).
  • Manage billing.
  • View and export audit logs and sign-in logs (see Audit & Monitoring).
  • Everything except the executive-exclusive actions below.

Executive

Everything an administrator can do, plus the exclusive abilities to:

  • Manage branding and security settings, including the branding, custom CSS and links of a custom domain.
  • Manage single sign-on, including adding, verifying and removing SSO email domains (see Auth0 Integration).
  • Delete the entire organization (see Account Deletion & Privacy).

The isApprover flag

Leave approval comes from the role: department heads approve for their departments, and administrators and executives for the organization. The isApprover flag on a person's record adds nothing to those roles, and there is no setting that turns it on for an employee.

When someone's role is changed to Employee, the flag is cleared, so a person who is demoted (for example an organization's founder handing the executive role to someone else) stops approving leave. The change is recorded in the audit log.

If an employee does still carry the flag, it gives them only the requests assigned to them as first- or second-level approver. A private leave type shows to them as "Private", with its reason and notes hidden, as it does for any other employee.

Department scoping

A Department Head's reach is bounded to users who share their department. They can only view and act on people in the same department — the server enforces this on every department-scoped action. Naming a department outside that scope, for example as a report filter, is refused rather than ignored.

1:1 series

Changing a 1:1 series (its cadence, time, pausing or resuming it, or its linked review cycle) takes the same right as setting one up: an executive, an administrator for anyone but themselves, or a department head for people in their department. Being one of the two participants is not enough. Participants can still add meetings, agenda items and notes. See Performance.

Clock-in locations

Everyone can see who is clocked in and their hours. The location recorded at clock-in (coordinates and address) is shown only to department heads for people in their department, to administrators and executives, and to each person for their own entries. See Clock-in & Location.

Company Directory set to "Admins only"

When an organization limits the Company Directory to administrators (or to administrators and department heads), an employee's directory and people list show only themselves. Colleagues still appear by name and photo where the employee's work needs them, such as schedules and timesheets, but without email, job title, manager, location or level. See Directory & Profiles.

Capability matrix

CapabilityEmployeeDept HeadAdminExecutive
Manage own leave/time/expensesYesYesYesYes
Cancel own approved leaveNo (request it)No (request it)YesYes
Approve in own departmentIf isApproverYesYesYes
Approve any departmentIf isApprover*NoYesYes
View usersDirectory settings decideYesYesYes
See clock-in locationsOwn onlyOwn departmentYesYes
Change a 1:1 seriesNoOwn departmentYes (not their own)Yes
Edit compensationNoNoYesYes
Create admins/execsNoNoYesYes
Publish schedulesNoNoYesYes
Manage billingNoNoYesYes
Manage org settingsNoNoYesYes
View/export audit & sign-in logsNoNoYesYes
Branding & security settingsNoNoNoYes
SSO settings and SSO domainsNoNoNoYes
Delete the organizationNoNoNoYes

* An employee with isApprover decides only the requests assigned to them as first- or second-level approver; department heads remain bound by department scoping.

Billing is admin or executive — not executive-only. Either role can manage the subscription. See Plans.

Troubleshooting

SymptomCauseFix
"Request cancellation" instead of a Cancel button on approved leaveEmployees/dept heads can't cancel their own approved leave.Submit a cancellation request for an approver to action.
A dept head can't see a userThe user is in a different department.Department scoping limits heads to their own department; an admin must act, or move the user.
Settings → Security returns 403Audit/sign-in logs are for administrators and executives.Ask an administrator or executive, or have your role reviewed.
Can't edit a salary fieldCompensation is admin/executive only.An administrator or executive must make the change.
An employee needs to approve requestsThey're an employee without approval rights.Set their isApprover flag instead of promoting them.
An employee approver can't see a requestIt isn't assigned to them as first- or second-level approver.Expected. Assign them as the approver, or have a department head or administrator decide it.
A department head can't open a document in their departmentHR or an administrator sent it.Expected. Department heads open only the documents they sent and their own.