Quinyx automation · runs weekly

Attest Quinyx worked hours before payroll

Payroll cannot start until every punch is attested, so on the last day of the period a manager goes down the Schedule view row by row, opening punches and ticking boxes.

Cotlet does it in your own Quinyx account with list_timesheet_approvals and attest_hours, called by your AI agent, an n8n workflow or a script.

Sign up free All Quinyx tools

Hosted · nothing to install or maintain

Can Quinyx do this on its own?

Quinyx lets a manager attest by day, employee or period in the web app. Its API references list no operation to attest hours (checked 22 Oct 2026): v2 covers absences, employees, groups, forecasts and pay schedules, and v3 employees, groups, roles and shifts.

How you do it in Quinyx today

  1. The manager opens the Schedule view, selects the dates of the pay period and, if needed, filters the rows.
  2. Quinyx can filter on attest status: Employee missing approval, Manager approval missing, Has employee approval and Has manager approval.
  3. Clicking a punch opens the Edit punch dialog. It shows the original start and end next to the edited ones, and a red frame around a punch means it has warnings.
  4. For a clean row, the manager clicks the three dots right of the employee's name and chooses Attest all. A green circle appears around the avatar when everything in the period is attested.
  5. This repeats per employee every period, and Quinyx will not include an employee in the payroll file while their approval is missing if Transfer only fully approved times is on.

How to attest Quinyx worked hours before payroll

Prompt

For last week at Harbor Cafe, attest the worked hours of employees who already approved their own time and whose punches have no warnings. List everyone else with the reason.
  1. 01

    List what is missing

    list_timesheet_approvals runs for the pay period with status manager_approval_missing. Each row carries the punch, whether the employee and the manager have attested it, and any warnings.

  2. 02

    Keep the order Quinyx wants

    If your organization has Hierarchical approval on, the employee must approve first. Rows where employee_attested is false are not attested; the employee goes on your list as waiting for their own approval.

  3. 03

    Separate clean from flagged

    An employee with any punch that has a warning, such as an automatic punch-out that still needs a time change, is not attested. The agent names the date and the warning for you.

  4. 04

    Attest the clean rows

    attest_hours runs once per employee for the period. It attests the punches and absences in that date range, so the agent sends exactly the range it checked. It asks for your OK per employee until you switch confirmation off.

  5. 05

    Hand over the rest

    The report ends with who is left and why. Sending the payroll file stays a step in Quinyx that this job does not touch.

What you get back

Example data

Pay period 12 to 18 Oct, Harbor Cafe: 12 employees
Attested 9 (41 punches, 2 absences)
Waiting for their own approval 2: Tom Becker, Ana Lopez
Warnings on a punch 1: Maria Silva, 15 Oct, automatic punch-out
Payroll file not created

Other ways to ask

  • Every Monday at 8, attest last week for employees who approved their time and list the rest.
  • Show me only the punches with warnings for this period, and attest nothing.
  • Attest today's punches for the morning shift and leave the evening shift for tonight.

What Quinyx allows, and what to know first

  • Time settings sit under Account settings > Agreements > Time settings, apply to the whole account, and work the same for every manager role, including admins.
  • With Hierarchical approval on, an employee must approve time before a manager can; with Manager can approve employee off, a manager has no option to attest for employees.
  • Attest all affects only the punches and absences that are visible, so the date range and filters decide what gets attested. Attesting future events needs the Approve into future setting.
  • With Transfer only fully approved times on, an employee with missing attestation cannot be selected for the payroll file.

attest_hours asks for your OK by default. To run it weekly without you, switch confirmation off for that tool in your dashboard.

Sources: Quinyx Help: Attest all / unattest all worked hours · Quinyx Help: Time settings · Quinyx Developer Portal: API reference

Call attest_hours from a script

curl

curl -X POST https://cotlet.dev/api/v1/quinyx/groups/1042/hours/attest \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"employee_id":"3011","from":"2026-10-12","to":"2026-10-18"}'

Example response

{
  "employee": "Tom Becker",
  "from": "2026-10-12",
  "to": "2026-10-18",
  "attested": {
    "punches": 5,
    "absences": 0
  },
  "manager_attested": true
}

MCP: add https://cotlet.dev/mcp/v1 with the same key; the call is quinyx_write → attest_hours. Example data.

Schedule it in n8n, Make, Zapier or cron

Quinyx tools this automation uses

Cotlet Quinyx tools used to attest Quinyx worked hours before payroll
Tool Parameters
list_timesheet_approvals group_id, from, to, employee_id, status
attest_hours group_id, employee_id, from, to
All 13 Quinyx tools with descriptions

Frequently asked questions

Is it safe to connect Quinyx to Cotlet?

Yes. You sign in to Quinyx yourself, in your own Cloud Browser in the EU, and we never save your password. Your agents only get Quinyx once you enable it, every background request is listed, and the browser profile is stored encrypted with AES-256-GCM, the cipher 1Password uses for its vaults. The AI model never sees a login, posts and messages wait for your OK, and Disable for agents cuts access in one click. Independent scanners grade cotlet.dev A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory; live results are on https://cotlet.dev/security.

Give your agent access to Quinyx.

Free 7-day trial with 2,000 credits, no card needed. Cotlet is independent and not affiliated with Quinyx.

Sign up free