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