Use Workday to read workers and organizations, create pre-hires, hire employees, update worker fields, assign onboarding plans, process job changes or terminations, and retrieve compensation details.

Provide the Workday instance URL, tenant, and Integration System User credentials with permission for the required business processes. Hiring, job-change, and termination requests can be subject to your tenant's approvals; a returned event ID does not by itself prove that the business process completed.

Use the block

Create pre-hires, hire employees, manage worker profiles, assign onboarding plans, handle job changes, retrieve compensation data, and process terminations.

Actions

Get Workday Worker

Retrieve a specific worker profile including personal, employment, and organization data.

Inputs and outputs

Input

Parameter	Type	Required	Description
tenantUrl	string	Yes	Workday instance URL (e.g., https://wd5-impl-services1.workday.com)
tenant	string	Yes	Workday tenant name
username	string	Yes	Integration System User username
password	string	Yes	Integration System User password
workerId	string	Yes	Worker ID to retrieve (e.g., 3aa5550b7fe348b98d7b5741afc65534)

Output

Parameter	Type	Description
worker	json	Worker profile with personal, employment, and organization data

List Workday Workers

List or search workers with optional filtering and pagination.

Inputs and outputs

Input

Parameter	Type	Required	Description
tenantUrl	string	Yes	Workday instance URL (e.g., https://wd5-impl-services1.workday.com)
tenant	string	Yes	Workday tenant name
username	string	Yes	Integration System User username
password	string	Yes	Integration System User password
limit	number	No	Maximum number of workers to return (default: 20)
offset	number	No	Number of records to skip for pagination

Output

Parameter	Type	Description
workers	array	Array of worker profiles
total	number	Total number of matching workers

Create Workday Pre-Hire

Create a new pre-hire (applicant) record in Workday. This is typically the first step before hiring an employee.

Inputs and outputs

Input

Parameter	Type	Required	Description
tenantUrl	string	Yes	Workday instance URL (e.g., https://wd5-impl-services1.workday.com)
tenant	string	Yes	Workday tenant name
username	string	Yes	Integration System User username
password	string	Yes	Integration System User password
legalName	string	Yes	Full legal name of the pre-hire (e.g., "Jane Doe")
email	string	No	Email address of the pre-hire
phoneNumber	string	No	Phone number of the pre-hire
address	string	No	Address of the pre-hire
countryCode	string	No	ISO 3166-1 Alpha-2 country code (defaults to US)

Output

Parameter	Type	Description
preHireId	string	ID of the created pre-hire record
descriptor	string	Display name of the pre-hire

Hire Workday Employee

Hire a pre-hire into an employee position. Converts an applicant into an active employee record with position, start date, and manager assignment.

Inputs and outputs

Input

Parameter	Type	Required	Description
tenantUrl	string	Yes	Workday instance URL (e.g., https://wd5-impl-services1.workday.com)
tenant	string	Yes	Workday tenant name
username	string	Yes	Integration System User username
password	string	Yes	Integration System User password
preHireId	string	Yes	Pre-hire (applicant) ID to convert into an employee
positionId	string	Yes	Position ID to assign the new hire to
hireDate	string	Yes	Hire date in ISO 8601 format (e.g., 2025-06-01)
employeeType	string	No	Employee type (e.g., Regular, Temporary, Contractor)

Output

Parameter	Type	Description
workerId	string	Worker ID of the newly hired employee
employeeId	string	Employee ID assigned to the new hire
eventId	string	Event ID of the hire business process
hireDate	string	Effective hire date

Update Workday Worker

Update fields on an existing worker record in Workday.

Inputs and outputs

Input

Parameter	Type	Required	Description
tenantUrl	string	Yes	Workday instance URL (e.g., https://wd5-impl-services1.workday.com)
tenant	string	Yes	Workday tenant name
username	string	Yes	Integration System User username
password	string	Yes	Integration System User password
workerId	string	Yes	Worker ID to update
fields	json	Yes	Fields to update as JSON (e.g., {"businessTitle": "Senior Engineer", "primaryWorkEmail": "new@company.com"})

Output

Parameter	Type	Description
eventId	string	Event ID of the change personal information business process
workerId	string	Worker ID that was updated

Assign Workday Onboarding Plan

Create or update an onboarding plan assignment for a worker. Sets up onboarding stages and manages the assignment lifecycle.

Inputs and outputs

Input

Parameter	Type	Required	Description
tenantUrl	string	Yes	Workday instance URL (e.g., https://wd5-impl-services1.workday.com)
tenant	string	Yes	Workday tenant name
username	string	Yes	Integration System User username
password	string	Yes	Integration System User password
workerId	string	Yes	Worker ID to assign the onboarding plan to
onboardingPlanId	string	Yes	Onboarding plan ID to assign
actionEventId	string	Yes	Action event ID that enables the onboarding plan (e.g., the hiring event ID)

Output

Parameter	Type	Description
assignmentId	string	Onboarding plan assignment ID
workerId	string	Worker ID the plan was assigned to
planId	string	Onboarding plan ID that was assigned

Get Workday Organizations

Retrieve organizations, departments, and cost centers from Workday.

Inputs and outputs

Input

Parameter	Type	Required	Description
tenantUrl	string	Yes	Workday instance URL (e.g., https://wd5-impl-services1.workday.com)
tenant	string	Yes	Workday tenant name
username	string	Yes	Integration System User username
password	string	Yes	Integration System User password
type	string	No	Organization type filter (e.g., Supervisory, Cost_Center, Company, Region)
limit	number	No	Maximum number of organizations to return (default: 20)
offset	number	No	Number of records to skip for pagination

Output

Parameter	Type	Description
organizations	array	Array of organization records
total	number	Total number of matching organizations

Change Workday Job

Perform a job change for a worker including transfers, promotions, demotions, and lateral moves.

Inputs and outputs

Input

Parameter	Type	Required	Description
tenantUrl	string	Yes	Workday instance URL (e.g., https://wd5-impl-services1.workday.com)
tenant	string	Yes	Workday tenant name
username	string	Yes	Integration System User username
password	string	Yes	Integration System User password
workerId	string	Yes	Worker ID for the job change
effectiveDate	string	Yes	Effective date for the job change in ISO 8601 format (e.g., 2025-06-01)
newPositionId	string	No	New position ID (for transfers)
newJobProfileId	string	No	New job profile ID (for role changes)
newLocationId	string	No	New work location ID (for relocations)
newSupervisoryOrgId	string	No	Target supervisory organization ID (for org transfers)
reason	string	Yes	Reason for the job change (e.g., Promotion, Transfer, Reorganization)

Output

Parameter	Type	Description
eventId	string	Job change event ID
workerId	string	Worker ID the job change was applied to
effectiveDate	string	Effective date of the job change

Get Workday Compensation

Retrieve compensation plan details for a specific worker.

Inputs and outputs

Input

Parameter	Type	Required	Description
tenantUrl	string	Yes	Workday instance URL (e.g., https://wd5-impl-services1.workday.com)
tenant	string	Yes	Workday tenant name
username	string	Yes	Integration System User username
password	string	Yes	Integration System User password
workerId	string	Yes	Worker ID to retrieve compensation data for

Output

Parameter	Type	Description
compensationPlans	array	Array of compensation plan details
↳ id	string	Compensation plan ID
↳ planName	string	Name of the compensation plan
↳ amount	number	Compensation amount
↳ currency	string	Currency code
↳ frequency	string	Pay frequency

Terminate Workday Worker

Initiate a worker termination in Workday. Triggers the Terminate Employee business process.

Inputs and outputs

Input

Parameter	Type	Required	Description
tenantUrl	string	Yes	Workday instance URL (e.g., https://wd5-impl-services1.workday.com)
tenant	string	Yes	Workday tenant name
username	string	Yes	Integration System User username
password	string	Yes	Integration System User password
workerId	string	Yes	Worker ID to terminate
terminationDate	string	Yes	Termination date in ISO 8601 format (e.g., 2025-06-01)
reason	string	Yes	Termination reason (e.g., Resignation, End_of_Contract, Retirement)
notificationDate	string	No	Date the termination was communicated in ISO 8601 format
lastDayOfWork	string	No	Last day of work in ISO 8601 format (defaults to termination date)

Output

Parameter	Type	Description
eventId	string	Termination event ID
workerId	string	Worker ID that was terminated
terminationDate	string	Effective termination date