Workday Integration

The Workday integration lets agents look up employee records, search your workforce, retrieve org data, and submit absence requests — directly from a conversation. Use it for HR self-service agents or internal support bots.

Authentication

Workday uses OAuth2 bearer token authentication.

Field	Description
Tenant	Your Workday tenant name (e.g. mycompany)
Access Token	OAuth2 bearer token with appropriate Workday API scopes

To generate an access token, follow your organisation's Workday OAuth2 setup. The integration account needs the following Workday security group permissions:

• Worker Data: Public Worker Reports — for worker lookups
• Organization Data — for org queries
• Absence Data — for absence request creation

Installing

1. Go to your project → Integrations → Browse
2. Find Workday and click Install
3. Enter your Tenant and Access Token
4. Select the actions you want to enable
5. Click Install

Actions

get_worker — Get Worker

Retrieves an employee record by worker ID.

Tool reference: {{tool:workday_get_worker}}

Parameter	Required	Description
worker_id	Yes	Workday worker ID (WID or Employee ID)

Returns: Worker details including name, title, department, email, manager, hire date

---

search_workers — Search Workers

Searches the workforce by name or keyword.

Tool reference: {{tool:workday_search_workers}}

Parameter	Required	Description
search_term	Yes	Name or partial name to search
limit	No	Maximum results to return (default 10)

Returns: Array of matching workers with worker_id, name, title, department

---

get_organization — Get Organization

Retrieves details about an organizational unit.

Tool reference: {{tool:workday_get_organization}}

Parameter	Required	Description
org_id	Yes	Workday organization ID

Returns: Org name, type, hierarchy, and member count

---

create_absence_request — Create Absence Request

Submits a time-off request for a worker.

Tool reference: {{tool:workday_create_absence_request}}

Parameter	Required	Description
worker_id	Yes	Worker to submit the request for
start_date	Yes	Start date of the absence (YYYY-MM-DD)
end_date	Yes	End date of the absence (YYYY-MM-DD)
comment	No	Optional note to include with the request

Returns: request_id, status, submitted_date

---

update_worker — Update Worker

Updates a worker's profile fields.

Tool reference: {{tool:workday_update_worker}}

Parameter	Required	Description
worker_id	Yes	Worker to update
business_title	No	Updated job title
work_email	No	Updated work email address

---

Using Workday in an agent

HR self-service agent

You are an HR assistant for internal employees.

When an employee asks to look up a colleague:
- Use {{tool:workday_search_workers}} to find them by name
- Return their name, title, department, and manager

When an employee wants to request time off:
- Confirm their worker ID (or look it up if they give their name)
- Ask for start date, end date, and any notes
- Use {{tool:workday_create_absence_request}} to submit the request
- Confirm the request ID: "Your absence request has been submitted — reference ID: [ID]"

When an employee asks about a team or department:
- Use {{tool:workday_get_organization}} with the org ID if known
- Or search workers with the department name as the search term

Troubleshooting

401 Unauthorized

The access token has expired or is invalid. Workday tokens have a limited lifetime — regenerate and reinstall.

404 Worker not found

The worker ID doesn't exist in your Workday tenant, or the integration account doesn't have access to that worker's data security group.

Absence request rejected

Some absence types require supervisor approval or have blackout dates. The request is still submitted but may be routed for approval — check the request status in Workday.

Access errors on org data

The integration account may not have the Organization Data security group permission. Contact your Workday administrator to grant the required access.