Time Approvals

How time entries reach the approvals queue, who can approve them, the approve/reject action, and what notifications and integrations fire on approval.

This page covers reviewing time entries — the queue, who can act, and what happens when you approve.

How entries reach the queue

When your organization's "require approval" time setting is on, a time entry gets an approvalStatus of PENDING on clock-out or when a manual entry is created.

Two roles auto-approve their own entries regardless of the setting:

  • EXECUTIVE — own entries auto-approved.
  • ADMINISTRATOR — own entries auto-approved.

See Overtime and lockdown for the time-tracking settings that govern this.

The clock-in form shows the note "Time entries require manager approval" only to people whose entries will actually wait for approval. Administrators and executives, whose own entries are approved as they are written, do not see it.

Who can approve

Only ADMINISTRATOR, EXECUTIVE, and DEPARTMENT_HEAD can approve time entries.

Department heads are department-scoped. A department head only sees entries from their own department — and one with no department assigned sees an empty list.

The queue and the action

OperationEndpointNotes
ListGET /api/time-tracking/approvals?status=PENDING|APPROVED|REJECTEDReturns { entries, counts }.
DecidePUT /api/time-tracking/approvals/:idBody { action: approve | reject, reason }.
Only completed entries can be approved. An entry must be clocked out before it can be approved — an in-progress entry isn't reviewable yet.
Entries in a finalized or signed timesheet can't be approved or rejected. The signed timesheet is the record, so it must always match its entries. Any entry still pending when its timesheet is finalized leaves this queue and every pending count (the sidebar badge, the Home card and the mobile app). This applies in the app and through the public API.

What happens on approval

When you approve an entry:

  • The employee is notified (in-app and email).
  • If QuickBooks is connected, the entry syncs to QuickBooks.

A note on "auto-approve after N days"

There is an "auto-approve after N days" setting, but it is not currently enforced by any background job. Don't rely on entries clearing themselves — review and action them in the queue.