Workday (via REST API)
Workday·AE_HSc_Workday_RestConnectorGuide
Overview
The Workday REST connector integrates AlertEnterprise Guardian with Workday via Workday's RESTful APIs. Workday is the dominant cloud HCM platform in the Fortune 500 — supporting Workday is mandatory for AE in any large deployment.
This is the REST-based integration path. For the older Workday Web Service (SOAP) integration, see the hand-authored workday connector. New deployments should prefer this REST connector.
Architecture: AE → ACF (REST Connector Framework) → Workday REST Connector → Workday RESTful APIs → Workday System.
Architecture
Composed from this connector's actors + edges. Trust zones are color-coded; trust crossings render as thicker lines.
Authentication
1 method supported
Workday authentication uses an Integration System User (ISU) credential — typically API key or basic auth depending on the Workday tenant's integration security configuration. The ISU must have an Integration System Security Group with read-access to the relevant Workday data domains (Workers, Organizations, Job Profiles, etc.).
Prerequisites
Everything that must be in place for this connector to work, with the owner who's responsible.
Workday tenant with REST API enabled
customerAn operational Workday tenant with REST API access enabled. Tenant admin must enable API access at the appropriate version (8.4+).
Workday Integration System User (ISU) with required scopes
customerISU configured in Workday with an Integration System Security Group granting access to the Worker / Organization / Job Profile / Position data domains the connector consumes.
HR specifics
- Sync modes
- full-load · delta
- Scheduled sync
- configurable
- Direction
- inbound
- Contingent worker support
- Yes
Workday's standard Worker object — workerID, employeeID, firstName, lastName, preferredName, hireDate, terminationDate, employmentStatus, jobProfile, supervisoryOrganization, manager, location, costCenter. Customers extending with Workday's custom fields configure additional mappings in AE.
Workday REST API supports bulk worker extraction with pagination.
- src/connectors/workday-rest/source.pdf — Full connector guide — 24 pages, updated 2025-04-17
- src/connectors/workday-rest/source.pdf — p5 — Supported Version