Skip to content

Start building

Integration · HR and recruiting

AI agents for When I Work

Read and build When I Work schedules: list shifts, add or change a shift, list, request and approve or deny time off, read time clock entries, and list users, schedules (locations) and positions, as a When I Work user.

Actions
10
Read
6
Write
4

Actions

What your agents can do in When I Work

10 actions. Each one is a tool your agents can call and a step your workflows can run.

Read 6

Look things up. Nothing changes.

  • List shifts

    Lists shifts between two times (the next three days if left out), optionally for one user or some schedules (locations), with open shifts and unpublished ones if asked.

  • List time-off requests

    Lists time-off requests in a date range, optionally for some users, a schedule or a status (0 pending, 1 canceled, 2 accepted, 3 expired).

  • List time clock entries

    Lists clocked times (punches) between two times (the last three days if left out), optionally for some users, only those still open (clocked in, not out), or changed since a time.

  • List users

    Lists the workplace's users (employees, supervisors, managers), optionally matching a search or on one schedule.

  • List schedules

    Lists the workplace's schedules (locations), each with id, name, address and place.

  • List positions

    Lists the workplace's positions (Cashier, Cook …), each with id, name and color.

Write 4

Create, change or send.

  • Add a shift

    Adds a shift on a schedule (location): start and end time, optionally the user working it (leave out for an open shift), a position, unpaid break hours, notes and whether to publish it.

  • Change a shift

    Changes a shift: its times, the user working it (0 makes it open), the schedule, position, break hours, notes or published state.

  • Request time off

    Creates a pending time-off request for a user from a start to an end time, with the paid hours it uses and its type (a request type ID, like Personal, Sick or Holiday, as shown on existing requests).

  • Accept or cancel a time-off request

    Sets a time-off request's status: 2 accepts it, 1 cancels it (as a manager or admin; the requester can also cancel their own).

A person can approve first

Any write action can be set to wait for a person's approval before it runs, so an agent asks before it changes anything.

Connection

How it connects

Connect it once in the console, then give it to the agents and workflows that need it.

Sign-in details

Enter the sign-in details When I Work gives you for its API.

What you enter

  • Developer key
  • Email address
  • Password

Kept safe

  • Credentials are stored encrypted with your organization's own keys.
  • They are opened only by the process that makes the call, at the moment it runs, and never go into a prompt or the browser.
  • Calls go only to the tool's own servers.

How we protect your data

Ideas

Ideas to start with

Starting points made only from the actions above. Mix them with any other tool your agents can use.

  • 01

    Ask about your When I Work data

    Ask a question in plain words. The agent can list shifts, list time-off requests or list time clock entries in When I Work, then answers with what it found.

  • 02

    Let an agent update When I Work

    Have the agent add a shift or change a shift in When I Work as part of a larger task. Turn on approval and a person signs off on each change first.

  • 03

    Share what it finds in Slack

    Give one agent When I Work and Slack: it can list shifts in When I Work and post a summary to a Slack channel in the same run.

FAQ

When I Work and MyDeepAgents

Can MyDeepAgents connect to When I Work?

Yes. The When I Work connector has 10 actions: 6 read and 4 make changes. Your agents can call them as tools, and your workflows can run them as steps.

How do I connect When I Work?

Enter the sign-in details When I Work gives you for its API. You'll need: Developer key, Email address and Password. Credentials are stored encrypted with your organization's own keys and are opened only at the moment of a call.

Can an agent change data in When I Work without asking?

Only if you let it. Each of the 4 actions that change data can be set to wait for a person's approval before it runs.

Can I use When I Work in workflows as well as agents?

Yes. Every When I Work action also works as a step in a workflow, and the same connection serves your agents and your workflows.

Early access

Put When I Work to work

Connect it in a few minutes, give an agent the actions it needs, and decide which changes wait for a person.