Quinyx automation · runs daily

Offer open Quinyx shifts to the right employees

A colleague calls in sick, the shift goes back to unassigned, and the manager opens it, picks people one by one and sends the offer while the shift start comes closer.

Cotlet does it in your own Quinyx account with list_shifts, list_employees and offer_shift, 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 offer an unassigned shift by hand, and its API has no operation to offer or assign shifts (checked 22 Oct 2026). The v3 Shift resource is read-only, with the scope schedule:shifts:read.

How you do it in Quinyx today

  1. A superuser turns the feature on under Account settings > Compliance settings. After that, managers see it in the Schedule view and employees in the mobile app, about an hour later.
  2. The manager opens an unassigned shift in the Schedule view and clicks Offer shift. The shift must be in the published period.
  3. In the panel the manager selects one or more employees, writes a comment on why they were picked and clicks Send offer.
  4. Each employee gets a Qmail and approves or denies the shift in a dedicated place in the mobile app. The manager gets a Qmail for either answer.
  5. The same steps repeat for every open shift, and the other route, employees booking an available shift themselves, still ends in a manager approving under Shift bookings.

How to offer open Quinyx shifts to the right employees

Prompt

List the unassigned shifts in the next 7 days at Harbor Cafe. For each one, offer it to the 3 employees who have no shift that day, with a short comment, and skip shifts that already have a pending offer.
  1. 01

    Find the open shifts

    list_shifts runs with unassigned_only for the next 7 days in your unit. Shifts in a period that is not published yet cannot be offered, so the agent leaves them out and says how many it skipped.

  2. 02

    Skip shifts already on offer

    A shift with a pending offer comes back with offer_pending set to true. The agent leaves it alone, because Quinyx keeps the shift and its offer locked while the offer is active.

  3. 03

    Pick who gets the offer

    list_employees returns the active people of the unit; passive employees cannot be assigned a shift and are dropped. The agent then reads list_shifts for them on the same days and keeps those without a shift that day. Rest and hour rules stay with Quinyx.

  4. 04

    Send the offers

    offer_shift goes out once per shift, to 2 or 3 employees at a time, with a comment such as why the shift is open and when it starts. The offer reaches people, so it waits for your OK by default.

  5. 05

    Report what is left

    Next run, shifts whose offers were denied, or whose offers lapsed when the shift started, show up again as unassigned and are offered to different people. The agent lists shifts that stay open after two rounds for you.

What you get back

Example data

Unassigned shifts, next 7 days: 5
Offered 4, e.g. Fri 30 Oct 06:00-14:00 to Tom Becker, Maria Silva, Ana Lopez
Already on offer: 1
Not offered 0 (all in the published period)
Still open after two rounds: 0

Other ways to ask

  • Every Monday, offer next week's open evening shifts to employees who worked fewer than 30 hours this week.
  • Offer today's open shifts to one employee at a time, in the order of my favorites, and wait for a decision before the next.
  • Show the unassigned shifts for the next 2 weeks and who is free for each, but send no offers.

What Quinyx allows, and what to know first

  • The offer is available only on unassigned shifts in the published period, including shifts on the current date. A section whose publish date is later than its unit's must be opened at section level before a shift can be offered.
  • When an offer goes to several employees, the first to accept is assigned the shift, and Quinyx tells the others that the offer is no longer available.
  • If nobody accepts before the shift starts, Quinyx denies the offer automatically and the shift stays unassigned.
  • While an offer is active, neither the shift nor the offer can be edited, and the shift no longer shows as unassigned in the mobile app.
  • Unassigned shifts appear under Schedule Overview in the Notifications panel only when the schedule that holds them has been published.

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

Sources: Quinyx Help: Offer additional shifts to employees · Quinyx Help: Notifications panel · Quinyx Help: Shifts · Quinyx Developer Portal: API reference

Call offer_shift from a script

curl

curl -X POST https://cotlet.dev/api/v1/quinyx/shifts/90518/offer \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"employee_ids":["3011","3027","3044"],"comment":"Open Friday opening shift after a sick call. First to accept gets it."}'

Example response

{
  "offer_id": "5521",
  "shift_id": "90518",
  "status": "pending",
  "offered_to": [
    "Tom Becker",
    "Maria Silva",
    "Ana Lopez"
  ],
  "comment": "Open Friday opening shift after a sick call. First to accept gets it."
}

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

Schedule it in n8n, Make, Zapier or cron

Quinyx tools this automation uses

Cotlet Quinyx tools used to offer open Quinyx shifts to the right employees
Tool Parameters
list_shifts group_id, from, to, employee_id, unassigned_only
list_employees group_id, query, include_passive
offer_shift shift_id, employee_ids, comment
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