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.
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.
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.