Skip to main content

What is the Payroll Agent and how does it work?

A
Written by Adrian Quinn

The Payroll Agent checks payroll runs against instructions you define and flags anything that needs a closer look before the cycle closes. You set the instructions in plain language and the agent runs the review automatically.

Unlike the Time Off and Expenses agents, the Payroll Agent does not auto-approve or auto-decline. Every flagged item comes to you for a final decision.

How the agent works

  1. A payroll run is initiated.

  2. The agent checks your instructions, top to bottom.

  3. If the run matches an instruction, it is flagged and sent to you for review with the agent's reasoning included.

  4. If no instruction matches, the run proceeds as normal.

  5. Every flag and decision is logged permanently with the instruction that triggered it visible at any time.

The order of your instructions determines priority. The agent applies the first matching instruction it finds.

Example use cases

Catching unusual payment spikes before a cycle closes

I set the instruction: "Flag any payment that is more than 25% higher than the same contractor's payment last month." Before the cycle closed, the agent surfaced three items. One was a legitimate milestone payment, one was a data entry error, and one needed a contract check. All three were reviewed and resolved before payroll went out.

First-payment checks for new starters

I set the instruction: "Flag all first payments for contractors who joined in the last 30 days." The agent caught every new starter payment automatically, giving me a chance to confirm the rate, contract type, and banking details were correct before anything was processed.

What conditions can you set?

When writing your instructions, you can base them on any of the following:

  • Payment type — salary, bonus, commission, adjustments, and the rest

  • Worker type — limit to specific contract types

  • Amount — compare the payment against a fixed threshold

  • Deviation from contract — compare the payment against the contracted amount, in percent

  • Country / Entity — limit to specific countries or entities

  • Currency — limit to specific contract or payment currencies

  • Contract tenure — require a minimum time on the contract

  • Recent payment count — cap by number of recent payments

Did this answer your question?