Workday

Use the Workday connector to invoke Workday SOAP and REST services for performing various on-demand business management services.

This connector is available in the following products and regions:

Service	Class	Regions
Copilot Studio	Premium	All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD)
Logic Apps	Standard	All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD)
Power Apps	Premium	All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD)
Power Automate	Premium	All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD)

Contact
Name	Microsoft
URL	https://support.microsoft.com

Connector Metadata
Publisher	Microsoft
Website	https://www.workday.com/
Privacy policy	https://www.workday.com/en-us/privacy.html
Categories	Human Resources

Creating a connection

The connector supports the following authentication types:


Basic	Provide a username and password to access the Workday service.	All regions	Not shareable
Microsoft Entra ID Integrated	Access your Workday instance with Microsoft Entra ID.	All regions	Not shareable
Microsoft Entra ID Integrated with API Management	Access your Workday instance with Microsoft Entra ID through the API Management service.	All regions	Not shareable
OAuth 2.0	Access your Workday instance using OAuth 2.0 authentication.	All regions	Not shareable
Default [DEPRECATED]	This option is only for older connections without an explicit authentication type, and is only provided for backward compatibility.	All regions	Not shareable

Basic

Auth ID: basic

Applicable: All regions

Provide a username and password to access the Workday service.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name	Type	Description	Required
SOAP base URL	string	Workday instance endpoint URL (format: https://<workday-host-name>.workday.com/ccx/service)	True
Tenant name	string	Workday instance tenant name	True
Username	securestring	Workday account username (format: <user>@<tenant-name>)	True
Password	securestring	Workday account password	True

Microsoft Entra ID Integrated

Auth ID: oauth

Applicable: All regions

Access your Workday instance with Microsoft Entra ID.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name	Type	Description	Required
Microsoft Entra resource URL (Application ID URI)	string	URL identifier in Microsoft Entra ID for the target resource	True
Workday OAuth token URL	string	Workday OAuth token endpoint URL (format: https://<workday-host-name>.workday.com/ccx/oauth2/<tenant-name>/token)	True
Workday OAuth client ID	string	Your Workday OAuth client ID	True
SOAP base URL	string	Workday instance endpoint URL (format: https://<workday-host-name>.workday.com/ccx/service)	True
REST base URL	string	Workday REST API root URL (format: https://<workday-host-name>.workday.com/ccx/api/<tenant-name>)
Tenant name	string	Workday instance tenant name	True

Microsoft Entra ID Integrated with API Management

Auth ID: oauthapim

Applicable: All regions

Access your Workday instance with Microsoft Entra ID through the API Management service.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name	Type	Description	Required
Microsoft Entra resource URL (Application ID URI)	string	URL identifier in Microsoft Entra ID for the target resource	True
API Management service base URL	string	Endpoint URL for API Management (format: https://<apim-host-name>.azure-api.net/<APIM URL suffix>)	True
REST base URL	string	Workday REST API root URL (format: https://<workday-host-name>.workday.com/ccx/api/<tenant-name>)
Tenant name	string	Workday instance tenant name	True

OAuth 2.0

Auth ID: oauth2generic

Applicable: All regions

Access your Workday instance using OAuth 2.0 authentication.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name	Type	Description	Required
OAuth authorization URL	string	OAuth authorization endpoint URL from Workday (format: https://<workday-host-name>/workday/<tenant-name>/authorize)	True
OAuth token URL	string	OAuth token endpoint URL from Workday (format: https://<workday-host-name>/ccx/oauth2/<tenant-name>/token)	True
OAuth client ID	string	OAuth client ID from Workday	True
OAuth client secret	securestring	OAuth client secret from Workday	True
SOAP base URL	string	Workday instance endpoint URL (format: https://<workday-host-name>.workday.com/ccx/service)	True
REST base URL	string	Workday REST API root URL (format: https://<workday-host-name>.workday.com/ccx/api/<tenant-name>)
Workday tenant name	string	Workday instance tenant name	True

Default [DEPRECATED]

Applicable: All regions

This option is only for older connections without an explicit authentication type, and is only provided for backward compatibility.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name	Type	Description	Required
SOAP base URL	string	Workday instance endpoint URL (format: https://<workday-host-name>.workday.com/ccx/service)	True
Tenant name	string	Workday instance tenant name	True
Username	securestring	Workday account username (format: <user>@<tenant-name>)	True
Password	securestring	Workday account password	True

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	200	60 seconds

Actions

Execute RaaS operation	Execute RaaS (Report as a Service) operation.
Execute SOAP operation	Executes SOAP operation.
Get feedback templates (Preview)	Returns feedback templates configured in the tenant. Use templateType to filter by Feedback on Worker or Feedback on Self. Requires OAuth 2.0 authentication.
Get my worker profile (Preview)	Returns the Workday profile of the authenticated worker. Requires OAuth 2.0 authentication.
Get supervisory organizations managed by worker (Preview)	Returns the supervisory organizations managed by the specified worker. Use this to resolve a manager's worker ID to their supervisory organization ID for transfer operations. Requires OAuth 2.0 authentication.
Get worker direct reports (Preview)	Returns the list of workers who directly report to the specified worker. Requires OAuth 2.0 authentication.
Get worker inbox tasks (Preview)	Returns the inbox tasks assigned to the specified worker. Filter by status to view open or completed tasks. Requires OAuth 2.0 authentication.
Get worker pay slips (Preview)	Returns pay slip summaries for the specified worker, including pay components, totals, and dates. Requires OAuth 2.0 authentication.
Request feedback on worker (Preview)	Requests feedback on the specified worker from one or more responders. Requires OAuth 2.0 authentication.
Search workers (Preview)	Searches for workers by name. Use the search parameter to find workers for people picker scenarios. Requires OAuth 2.0 authentication.
Transfer employee (Preview)	Initiates a job change (transfer) for the specified worker to a new supervisory organization. Requires OAuth 2.0 authentication.

Execute RaaS operation

Operation ID:: RaaS_Operation

Execute RaaS (Report as a Service) operation.

Parameters

Name	Key	Required	Type	Description
Account name	accountName	True	string	The Workday report account name.
Report name	reportName	True	string	The Workday report name.
SOAP request body	requestBody	True	binary	The SOAP request body.
Report instance name	reportInstanceName	True	string	The Workday report instance name (example: Report2 or customReport2).

Returns

The SOAP response body.

SOAP response body: binary

Execute SOAP operation

Operation ID:: SOAP_Operation

Executes SOAP operation.

Parameters

Name	Key	Required	Type	Description
Service name	service	True	string	The Workday web service name.
Service version	version	True	string	The service version.
SOAP request body	requestBody	True	binary	The SOAP request body.

Returns

The SOAP response body.

SOAP response body: binary

Get feedback templates (Preview)

Operation ID:: GetFeedbackTemplates

Returns feedback templates configured in the tenant. Use templateType to filter by Feedback on Worker or Feedback on Self. Requires OAuth 2.0 authentication.

Parameters

Name	Key	Required	Type	Description
Search	search		string	Search term to filter templates by name.
Template type ID	templateType		string	The feedback template type ID. Use 133de7d11fea10001dbb45973dec0097 for Feedback on Worker or 133de7d11fea10001dbb45a701140098 for Feedback on Self.
Worker ID	worker		string	The worker WID. Required for Feedback on Worker template type.
Limit	limit		integer	The maximum number of templates to return. The default and maximum is 1000.
Offset	offset		integer	The zero-based index of the first template in the response. Use with limit for pagination.

Returns

List of feedback templates.

Body: FeedbackTemplatesResponse

Get my worker profile (Preview)

Operation ID:: GetWorkerMe

Returns the Workday profile of the authenticated worker. Requires OAuth 2.0 authentication.

Returns

A Workday worker summary.

Body: WorkerSummary

Get supervisory organizations managed by worker (Preview)

Operation ID:: GetSupervisoryOrganizationsManaged

Returns the supervisory organizations managed by the specified worker. Use this to resolve a manager's worker ID to their supervisory organization ID for transfer operations. Requires OAuth 2.0 authentication.

Parameters

Name	Key	Required	Type	Description
Worker ID	workerID	True	string	The Workday worker ID of the manager.
Limit	limit		integer	The maximum number of organizations to return. The default is 20. The maximum is 100.
Offset	offset		integer	The zero-based index of the first organization in the response. Use with limit for pagination.

Returns

Paginated list of supervisory organizations.

Body: SupervisoryOrganizationsResponse

Get worker direct reports (Preview)

Operation ID:: GetWorkerDirectReports

Returns the list of workers who directly report to the specified worker. Requires OAuth 2.0 authentication.

Parameters

Name	Key	Required	Type	Description
Worker ID	workerID	True	string	The Workday worker ID of the manager.
Limit	limit		integer	The maximum number of direct reports to return. The default is 20. The maximum is 100.
Offset	offset		integer	The zero-based index of the first direct report in the response. Use with limit for pagination.

Returns

Paginated list of direct reports.

Body: DirectReportsResponse

Get worker inbox tasks (Preview)

Operation ID:: GetWorkerInboxTasks

Returns the inbox tasks assigned to the specified worker. Filter by status to view open or completed tasks. Requires OAuth 2.0 authentication.

Parameters

Name	Key	Required	Type	Description
Worker ID	workerID	True	string	The Workday worker ID.
Limit	limit		integer	The maximum number of tasks to return. The default is 20. The maximum is 100.
Offset	offset		integer	The zero-based index of the first task in the response. Use with limit for pagination.

Returns

Paginated list of inbox tasks.

Body: InboxTasksResponse

Get worker pay slips (Preview)

Operation ID:: GetWorkerPaySlips

Returns pay slip summaries for the specified worker, including pay components, totals, and dates. Requires OAuth 2.0 authentication.

Parameters

Name	Key	Required	Type	Description
Worker ID	workerID	True	string	The Workday worker ID.
Limit	limit		integer	The maximum number of pay slips to return. The default is 20. The maximum is 100.
Offset	offset		integer	The zero-based index of the first pay slip in the response. Use with limit for pagination.

Returns

Paginated list of pay slips.

Body: PaySlipsResponse

Request feedback on worker (Preview)

Operation ID:: RequestFeedback

Requests feedback on the specified worker from one or more responders. Requires OAuth 2.0 authentication.

Parameters

Name	Key	Required	Type	Description
Worker ID	workerID	True	string	The Workday worker ID of the worker feedback is being requested about.
ID	id		string	The Workday resource ID.
ID	id		string	The Workday resource ID.
Confidential	feedbackConfidential		boolean	If true, feedback is confidential between the provider and manager. Workers do not see confidential feedback.
Show provider name	showFeedbackProviderName		boolean	If true, the responder's name is displayed. If false, they remain anonymous.
Expiration date	expirationDate		date	The date the feedback request expires (YYYY-MM-DD).

Returns

The created feedback request event.

Body: RequestFeedbackResponse

Search workers (Preview)

Operation ID:: SearchWorkers

Searches for workers by name. Use the search parameter to find workers for people picker scenarios. Requires OAuth 2.0 authentication.

Parameters

Name	Key	Required	Type	Description
Search	search		string	Search term to filter workers by name (case-insensitive).
Limit	limit		integer	The maximum number of workers to return. The default is 20. The maximum is 100.
Offset	offset		integer	The zero-based index of the first worker in the response. Use with limit for pagination.

Returns

Paginated list of workers.

Body: WorkerSummaryResponse

Transfer employee (Preview)

Operation ID:: TransferEmployee

Initiates a job change (transfer) for the specified worker to a new supervisory organization. Requires OAuth 2.0 authentication.

Parameters

Name	Key	Required	Type	Description
Worker ID	workerID	True	string	The Workday worker ID of the employee to transfer.
ID	id		string	The Workday resource ID.
ID	id		string	The Workday resource ID.
Effective date	effective	True	date	The date the transfer takes effect (YYYY-MM-DD).
Move manager's team	moveManagersTeam		boolean	If true, moves the worker's reporting team to the new supervisory organization.

Returns

The initiated job change process.

Body: JobChangeResponse

Definitions

WorkdayObjectReference

A Workday resource reference.

Name	Path	Type	Description
ID	id	string	The Workday resource ID.

InboxTask

A single Workday inbox task.

Name	Path	Type	Description
Task ID	id	string	The Workday ID of the inbox task.
Task title	descriptor	string	The display name of the inbox task.
Workday link	href	string	A link to the task in the Workday portal.
Assigned date	assigned	date	The date the task was assigned.
Due date	due	date	The due date for this task.
status	status	WorkdayObjectReference	A Workday resource reference.
stepType	stepType	WorkdayObjectReference	A Workday resource reference.
initiator	initiator	WorkdayObjectReference	A Workday resource reference.
subject	subject	WorkdayObjectReference	A Workday resource reference.
overallProcess	overallProcess	WorkdayObjectReference	A Workday resource reference.

InboxTasksResponse

Paginated list of inbox tasks.

Name	Path	Type	Description
Tasks	data	array of InboxTask	The list of inbox tasks.
Total	total	integer	Total number of tasks matching the filter.

JobChangeResponse

The initiated job change process.

Name	Path	Type	Description
Process ID	id	string	The job change process ID.
Task title	descriptor	string	A human-readable description of the job change.
Workday link	href	string	A link to the job change in the Workday portal.
Effective date	effective	date	The effective date of the transfer.
supervisoryOrganization	supervisoryOrganization	WorkdayObjectReference	A Workday resource reference.

RequestFeedbackResponse

The created feedback request event.

Name	Path	Type	Description
Event ID	id	string	The feedback request event ID.
Description	descriptor	string	A human-readable description of the feedback request.
Request date	requestDate	date	The date the feedback request was initiated.
Status	feedbackOverallStatus	string	The overall status of the feedback request process.
feedbackAbout	feedbackAbout	WorkdayObjectReference	A Workday resource reference.

FeedbackTemplate

A Workday feedback template.

Name	Path	Type	Description
Template ID	id	string	The feedback template ID.
Template name	descriptor	string	The display name of the feedback template.

FeedbackTemplatesResponse

List of feedback templates.

Name	Path	Type	Description
Templates	data	array of FeedbackTemplate	The list of feedback templates.
Total	total	integer	Total number of templates.

WorkerSummary

A Workday worker summary.

Name	Path	Type	Description
Worker ID	id	string	The Workday worker ID.
Worker name	descriptor	string	The worker's display name.
Worker URL	href	string	A link to the worker resource.
Is manager	isManager	boolean	Indicates whether the worker is a manager.
Business title	businessTitle	string	The worker's business title.
Work email	primaryWorkEmail	string	The worker's primary work email address.
Work phone	primaryWorkPhone	string	The worker's primary work phone number.
primarySupervisoryOrganization	primarySupervisoryOrganization	WorkdayObjectReference	A Workday resource reference.

WorkerSummaryResponse

Paginated list of workers.

Name	Path	Type	Description
Workers	data	array of WorkerSummary	The list of workers.
Total	total	integer	Total number of workers matching the search.

SupervisoryOrganization

A Workday supervisory organization.

Name	Path	Type	Description
Organization ID	id	string	The Workday supervisory organization ID.
Organization name	descriptor	string	The display name of the organization.
Organization URL	href	string	A link to the organization resource.
Name	name	string	The organization name.
Code	code	string	The organization code.

SupervisoryOrganizationsResponse

Paginated list of supervisory organizations.

Name	Path	Type	Description
Organizations	data	array of SupervisoryOrganization	The list of supervisory organizations.
Total	total	integer	Total number of supervisory organizations.

DirectReport

A worker who directly reports to the specified manager.

Name	Path	Type	Description
Worker ID	id	string	The Workday worker ID.
Worker name	descriptor	string	The worker's display name.
Worker URL	href	string	The URL link to the worker resource.
Is manager	isManager	boolean	Indicates whether the worker is a manager.
Business title	businessTitle	string	The worker's business title.
Work email	primaryWorkEmail	string	The worker's primary work email address.
Work phone	primaryWorkPhone	string	The worker's primary work phone number.
primarySupervisoryOrganization	primarySupervisoryOrganization	WorkdayObjectReference	A Workday resource reference.

DirectReportsResponse

Paginated list of direct reports.

Name	Path	Type	Description
Direct reports	data	array of DirectReport	The list of direct reports.
Total	total	integer	Total number of direct reports.

PaySlip

A single pay slip summary.

Name	Path	Type	Description
Pay slip ID	id	string	The pay slip ID.
Pay period	descriptor	string	The display name of the pay slip, typically includes the pay period dates.
Workday link	href	string	A link to the pay slip in the Workday portal.
Payment date	date	date	The payment date.
Gross pay	gross	number	Gross pay amount.
Net pay	net	number	Net pay amount after deductions.
status	status	WorkdayObjectReference	A Workday resource reference.

PaySlipsResponse

Paginated list of pay slips.

Name	Path	Type	Description
Pay slips	data	array of PaySlip	The list of pay slips.
Total	total	integer	Total number of pay slips.

binary

This is the basic data type 'binary'.