Roles & Permissions
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 four roles
| Role | In one line |
|---|---|
| Employee | Manages their own leave, time, and expenses. |
| Department Head | An employee who can also approve and manage their own department. |
| Administrator | Manages the whole organization except executive-exclusive actions. |
| Executive | Everything 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:
| Action | Documents they sent to people in their department | Their own documents | Documents HR or an administrator sent to their department |
|---|---|---|---|
| View and download | Yes | Yes | No |
| Audit trail | Yes | Yes | No |
| Rename or move | Yes | Only ones they uploaded | No |
| Delete | Yes | Only ones they uploaded, with no pending signatures | No |
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
| Capability | Employee | Dept Head | Admin | Executive |
|---|---|---|---|---|
| Manage own leave/time/expenses | Yes | Yes | Yes | Yes |
| Cancel own approved leave | No (request it) | No (request it) | Yes | Yes |
| Approve in own department | If isApprover | Yes | Yes | Yes |
| Approve any department | If isApprover* | No | Yes | Yes |
| View users | Directory settings decide | Yes | Yes | Yes |
| See clock-in locations | Own only | Own department | Yes | Yes |
| Change a 1:1 series | No | Own department | Yes (not their own) | Yes |
| Edit compensation | No | No | Yes | Yes |
| Create admins/execs | No | No | Yes | Yes |
| Publish schedules | No | No | Yes | Yes |
| Manage billing | No | No | Yes | Yes |
| Manage org settings | No | No | Yes | Yes |
| View/export audit & sign-in logs | No | No | Yes | Yes |
| Branding & security settings | No | No | No | Yes |
| SSO settings and SSO domains | No | No | No | Yes |
| Delete the organization | No | No | No | Yes |
* An employee with isApprover decides only the requests assigned to them as first- or second-level approver; department heads remain bound by department scoping.
Troubleshooting
| Symptom | Cause | Fix |
|---|---|---|
| "Request cancellation" instead of a Cancel button on approved leave | Employees/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 user | The 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 403 | Audit/sign-in logs are for administrators and executives. | Ask an administrator or executive, or have your role reviewed. |
| Can't edit a salary field | Compensation is admin/executive only. | An administrator or executive must make the change. |
| An employee needs to approve requests | They're an employee without approval rights. | Set their isApprover flag instead of promoting them. |
| An employee approver can't see a request | It 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 department | HR or an administrator sent it. | Expected. Department heads open only the documents they sent and their own. |
Account Deletion & Privacy
GDPR/CCPA controls in BookYourPTO — delete your account or organization with an emailed code, export your data, opt out of third-party syncs, and understand anonymization.
Plans
Compare the Free, Pro, Business, and Enterprise plans — what's included, the seat and usage limits, and which features unlock at each tier.