🏢 Workday HCM

Workday HCM — REST v1 API. Authoritative for employee master data, org units, positions.

Identification

• vendor key: workday
• engine: rest
• default role: authoritative_source
• type: Out-of-the-box vendor
• default authoritative for: employee_id, first_name, last_name, email, department, function, cost_center, location, manager_id, hire_date, end_date, employment_type
• vendor docs: https://community.workday.com/sites/default/files/file-hosting/restapi/index.html

Supported auth methods

• oauth2_client_credentials
• basic

Importable objects (4)

Object types the wizard offers to import out of the box.

Workers (employees)

• name: workers
• iga_target: identity
• path: /workers

All workers — query with ?activeOnly=true for active people only.

Default field mappings:

IGA field	Expression	Required
business_id	{{ workerNumber }}	✓
identity_id	{{ primaryWorkEmail|if_null(workerNumber) }}	✓
employee_id	{{ workerNumber }}	✓
email	{{ primaryWorkEmail }}
first_name	{{ legalNameFirstName }}
last_name	{{ legalNameLastName }}
display_name	{{ legalNameFirstName }} {{ legalNameLastName }}
function	{{ businessTitle }}
department	{{ primarySupervisoryOrganization.descriptor }}
location	{{ primaryWorkLocation.descriptor }}
manager_id	{{ manager.primaryWorkEmail|if_null(manager.workerNumber) }}
hire_date	{{ hireDate|date_format('%Y-%m-%d') }}
end_date	{{ terminationDate|if_null('31/12/9999')|date_format('%Y-%m-%d') }}
status	{{ 'active' if active else 'terminated' }}
cost_center	{{ primaryCostCenter.code|if_null('') }}
company	{{ primaryCompany.descriptor|if_null('') }}

Supervisory Organizations

• name: supervisory_orgs
• iga_target: reference
• path: /supervisoryOrganizations

Org structure — Workday's hierarchical containers.

Default field mappings:

IGA field	Expression	Required
business_id	{{ id }}	✓
name	{{ descriptor }}	✓
description	{{ descriptor }}
parent_business_id	{{ superiorOrganization.id }}

Job Profiles

• name: job_profiles
• iga_target: reference
• path: /jobs/jobProfiles

Job titles / job profiles.

Default field mappings:

IGA field	Expression	Required
business_id	{{ id }}	✓
name	{{ name }}	✓
description	{{ code|if_null('') }}

Locations

• name: locations
• iga_target: reference
• path: /locations

Default field mappings:

IGA field	Expression	Required
business_id	{{ id }}	✓
name	{{ name }}	✓
description	{{ country.descriptor }}

Onboarding setup checklist

Create an Integration System User (ISU), link a Security Group with the correct domain policies, and retrieve the REST endpoint URL. Requires Workday admin collaboration — expect 1-2 hours (not in IGA itself, but in the Workday config + handoff).

Estimated time: ~60 min. The wizard exposes this checklist as a drawer (📋 button) during onboarding. See the Onboarding wizard walkthrough for context.