---
sourceDocument: Brazil Workflow Data Fabric
sourceDocumentLink: https://www.servicenow.com/docs/r/integrate-applications

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Workflow Data Fabric

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Set up webhooks for your Workday HR spoke

# Set up webhooks for your Workday HR
spoke {#ariaid-title1}

Release version: Brazil  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 14 minutes to read  
Retrieve details the required employees in the Workday HR application
to your ServiceNow instance by setting up the webhooks.

## Before you begin

Role required: admin

## Configure ServiceNow Webhook API Client for OAuth 2.0 in Workday {#ariaid-title2}

Configure API client in Workday to authenticate webhook requests.

### Before you begin

Role required: Workday admin role or the role with granted permission to setup OAuth 2.0
client in Workday.

### About this task

You only need to configure this step if you want to use the ServiceNow platform as a listener endpoint, and receive event notifications from Workday. If you don't need to receive any event notifications from Workday, then you can skip the configurations mentioned in this section.  
Note:  
These configurations must be performed in Workday.

### Procedure

1. In Workday, access the Edit Tenant Setup - Security task.
2. Select the OAuth 2.0 Clients Enabled option from the OAuth 2.0 Settings section.
3. Access the Register API Client task.
4. Enter the Client Name.
5. Select the Client Grant Type as Authorization Code Grant.
6. Select Access Token Type as Bearer.
7. Enter a valid Redirection URI.  
   Note:  
   Make sure that the OAuth 2.0 Redirection URI is a valid HTTPS URL.
8. **Optional:** Select the Refresh Token Timeout in days.
9. **Optional:** Select the Non-Expiring Refresh Tokens option to prevent the refresh token from timing out.
10. Select the Grant Administrative Consent option to grant OAuth permission to a REST API Client tenant-wide.  
    When you select this option, you don't have to grant client access explicitly to Workday functional areas.
11. From the Functional Areas prompt, select the functional areas to which your OAuth 2.0 client requires access.
12. **Optional:** If the OAuth 2.0 client requires access to core Workday domains that aren't in any functional areas, select the Include Workday Owned Scope option.

## Set up CreateUser Webhook for the Workday HR spoke {#ariaid-title3}

Use the CreateUser Webhook to get the details of the newly onboarded employee from
Workday to your ServiceNow instance.

### Generate user name and password in your ServiceNow instance for
Create User webhook {#ariaid-title4}

Generate user name and password in your ServiceNow instance to
authenticate requests for Create User webhook and retrieve the required data from the Workday
application.

#### Before you begin

Role required: ServiceNow admin  
Note:  
These configurations must be performed in your ServiceNow instance.

#### Procedure

1. Log in to your ServiceNow instance as an admin.
2. Navigate to AllSystem DefinitionTable.
3. Filter and search for the Workday HR spoke webhook registry table.  
   For example, Workday Webhook Registry.
4. Click the Show List related list.
5. Click New.
6. On the form, fill these values.  
   {#generate-usrnm-pwd-wd-hr__table_xxp_1mg_pmb__entry__2}

   | Field | Description |
   |-|-|
   | Description | Description of the webhook registry record. Enter <kbd class="ph userinput">Workday event and authentication for Create User</kbd>. |
   | UserName | Workday user who has integration rights using Workday Web Services. |
   | Password | Password of the Workday user. |
   | Workday Event | Event for which the webhook is set up. Enter <kbd class="ph userinput">CreateUser</kbd>. |
   | Workday Instance | Workday host URL and tenant name. Enter the URL in this format:<kbd class="ph userinput">https://&lt;workday_host_url&gt;/&lt;workday_tenant_name&gt;</kbd> |
   [ ]

   {#generate-usrnm-pwd-wd-hr__table_xxp_1mg_pmb}
7. Right-click the form header and click Save.
8. Click Generate UserName And Password.  
   Copy and record the values of username and password. These values must be specified in the Workday instance to authenticate the webhook requests.  
   Note:  
   If you have more than one HIRE BP in your environment, you must configure all the HIRE BPs to enable the Create User webhook for all HIRE employee transactions.
{#generate-usrnm-pwd-wd-hr__steps_yd4_pfq_qmb}

### Retrieve the resource path from your ServiceNow instance for Create
User webhook {#ariaid-title5}

Retrieve the resource path from your ServiceNow instance for
later use to authenticate Create User webhook requests and retrieve the required data from
the Workday
application

#### Before you begin

Role required: ServiceNow admin.  
Note:  
These configurations must be performed in your ServiceNow instance.

#### Procedure

1. Log in to your ServiceNow instance as an admin.
2. Navigate to AllSystem Web ServicesScripted Web ServicesScripted REST APIs.
3. Open the record for the Workday HR spoke.
4. In the Resources tab, click the Callback record.
5. Record and save the value of Resource path for later use.
{#resource-path-wd-hr-spoke__steps_wvb_x3q_qmb}

### Import CLAR file to your Workday instance for
Create User webhook {#ariaid-title6}

Import CLAR file available at ServiceNow Store to set up Create User webhook
and authenticate requests from ServiceNow instance.

#### Before you begin

* Workday Studio should be installed.
* Access to custom report creation policy.Create custom report in workday based
  on the New_Hire_record report structure and share the report with ISU
  user.

* Access to edit business process definition.
* Access to create and edit integration system.
* Role required: admin

{#import-clar-wd-hr-spoke__ul_npc_nlq_qmb}  
Note:  
* Except integration name, report field XPath (if required), and Workday instance header, users are cautioned against modifying the values of fields or properties in the CLAR file.
* These configurations must be performed in Workday Studio.
{#import-clar-wd-hr-spoke__ul_czk_pgq_gxb}

#### Procedure

1. From the [Workday HR spoke](https://store.servicenow.com/sn_appstore_store.do#!/store/application/133e9dacdb910010ea4494d9db961988) page on [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home), download the Workday-HR-Webhook-Studio-Sample file from Supporting Links and Docs.
2. Unzip the sample file to obtain the CLAR file.
3. Import the CLAR file to Workday Studio.
4. In the Properties tab of the StartHere component, navigate to Services and select the RAAS report created for this webhook.  
5. Choose the environment where your report exists such as, implementation or sandbox and configure the report as per your requirement.
6. Provide a report name and select the required report.  
7. Provide the alias name of the report.  
8. After the report alias is added, add the selected path of report in Extra Path that is used to run the report based on prompt.  
9. In the Set Headers component, provide your Workday instance for the WorkdayInstance header.  
10. In the properties of HttpOut, fill in these values.  
    {#import-clar-wd-hr-spoke__table_nmg_zdl_qmb__entry__2}

    | Field | Value |
    |-|-|
    | Endpoint | REST endpoint Note: See [Retrieve the resource path from your ServiceNow instance](https://www.servicenow.com/docs/TA~EDLj8A_RVedO1iZ~C~A#resource-path-wd-fin-spoke "Retrieve the resource path from your ServiceNow instance for later use to authenticate requests and retrieve the required data from the Workday application") for more information. |
    | Http Method | POST |
    [ ]

    {#import-clar-wd-hr-spoke__table_nmg_zdl_qmb}
11. Save the changes.
12. In the project explorer, select the integration and deploy it in your Workday system.
13. Log in to your Workday instance and navigate to IntegrationIntegration SystemConfigure Integration Attributes.  
14. Provide user name and password in Configure Integration Attributes that you have generated in [Generate user name and password in your ServiceNow instance](https://www.servicenow.com/docs/TA~EDLj8A_RVedO1iZ~C~A#setup-wd-webhook "Generate user name and password in your ServiceNow instance to authenticate requests and retrieve the required data from the Workday application.").  
15. Modify a business process and add this integration in your business process.
    1. Edit definition of the business process.  
    2. Select the effective date and click Ok.
    3. Click the + sign and add a new business process step in BP.
    4. Select an order, which is after the completion step of business process.
    5. Add the business process and select Type as Integration.  
    6. Provide ISU username in Run as User and click Ok.
    7. Click Configure Integration on the newly added business process step in Hire BP.  
    8. In integration criteria, select value type as Determine value at runtime and select value as Employee ID.  

       Selected Employee ID field in value is
       displayed.
    9. Click Ok.
    10. Create a report for the webhook with these details:  
        Report definition:

        Column labels:

        Calculated field details:

        Filter and prompt details:
    {#import-clar-wd-hr-spoke__substeps_pgc_xj4_ymb}
{#import-clar-wd-hr-spoke__steps_ugq_4lq_qmb}

## Set up Offboarding Webhook for the Workday HR spoke {#ariaid-title7}

Use the Offboarding Webhook to get the details of the offboarded employee from Workday
to your ServiceNow instance.

### Generate user name and password in your ServiceNow instance for
Offboarding webhook {#ariaid-title8}

Generate user name and password in your ServiceNow instance to
authenticate requests for Offboarding webhook and retrieve the required data from the Workday
application.

#### Before you begin

Role required: admin  
Note:  
These configurations must be performed in your ServiceNow instance.

#### Procedure

1. Log in to your ServiceNow instance as an admin.
2. Navigate to AllSystem DefinitionTable.
3. Filter and search for the Workday HR spoke webhook registry table.  
   For example, Workday Webhook Registry.
4. Click the Show List related list.
5. Click New.
6. On the form, fill these values.  
   {#generate-username-pwd-offboarding-wd-hr__table_xxp_1mg_pmb__entry__2}

   | Field | Description |
   |-|-|
   | Description | Description of the webhook registry record. Enter <kbd class="ph userinput">Workday event and authentication for Offboarding</kbd>. |
   | UserName | Workday user who has integration rights using Workday Web Services. |
   | Password | Password of the Workday user. |
   | Workday Event | Event for which the webhook is set up. |
   | Workday Instance | Workday host URL and tenant name. Enter the URL in this format:<kbd class="ph userinput">https://&lt;workday_host_url&gt;/&lt;workday_tenant_name&gt;</kbd> |
   [ ]

   {#generate-username-pwd-offboarding-wd-hr__table_xxp_1mg_pmb}
7. Right-click the form header and click Save.
8. Click Generate UserName And Password.  
   Copy and record the values of username and password. These values must be specified in the Workday instance to authenticate the webhook requests.  
   Note:  
   If you have more than one HIRE BP in your environment, you must configure all the HIRE BPs to enable the Create User webhook for all HIRE employee transactions.
{#generate-username-pwd-offboarding-wd-hr__steps_yd4_pfq_qmb}

### Retrieve the resource path from your ServiceNow instance for
Offboarding webhook {#ariaid-title9}

Retrieve the resource path from your ServiceNow instance for
later use to authenticate Offboard webhook requests and retrieve the required data from the
Workday
application

#### Before you begin

Role required: admin.  
Note:  
These configurations must be performed in your ServiceNow instance.

#### Procedure

1. Log in to your ServiceNow instance as an admin.
2. Navigate to AllSystem Web ServicesScripted Web ServicesScripted REST APIs.
3. Open the record for the Workday HR spoke.
4. In the Resources tab, click the Callback record.
5. Record and save the value of Resource path for later use.

### Import CLAR file to your Workday instance for
Offboarding webhook {#ariaid-title10}

Import CLAR file available at ServiceNow Store to set up Offboarding webhook
and authenticate requests from ServiceNow instance.

#### Before you begin

* Workday Studio should be installed.
* Access to custom report creation policy.Create custom report in workday based
  on the New_terminated_record report structure and share the report with ISU
  user.

* Access to edit business process definition.
* Access to create and edit integration system.
* Role required: admin

{#import-clar-offbd-webhk-wd-hr__ul_umh_vkm_wqb}  
Note:  
* Except integration name, report field XPath (if required), and Workday instance header, users are cautioned against modifying the values of fields or properties in the CLAR file.
* These configurations must be performed in Workday Studio.
{#import-clar-offbd-webhk-wd-hr__ul_zm4_khq_gxb}

#### Procedure

1. From the [Workday HR spoke](https://store.servicenow.com/sn_appstore_store.do#!/store/application/133e9dacdb910010ea4494d9db961988) page on [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home), download the Workday-HR-Offboarding-Webhook-Studio-Sample file from Supporting Links and Docs.
2. Unzip the sample file to obtain the CLAR file.
3. Import the CLAR file to Workday Studio.
4. In the Properties tab of the StartHere component, navigate to Services and select the RAAS report created for this webhook.  
5. Choose the environment where your report exists such as, implementation or sandbox and configure the report as per your requirement.
6. Provide a report name and select the required report.  
7. Provide the alias name of the report.  
8. After the report alias is added, add the selected path of report in Extra Path that is used to run the report based on prompt.  
9. Select the report alias.
10. In the Set Headers component, provide your Workday instance for the WorkdayInstance header.  
11. In the properties of HttpOut, fill in these values.  
    {#import-clar-offbd-webhk-wd-hr__table_ryn_5mm_wqb__entry__2}

    | Field | Value |
    |-|-|
    | Endpoint | REST endpoint Note: See [Retrieve the resource path from your ServiceNow instance](https://www.servicenow.com/docs/TA~EDLj8A_RVedO1iZ~C~A#resource-path-wd-fin-spoke "Retrieve the resource path from your ServiceNow instance for later use to authenticate requests and retrieve the required data from the Workday application") for more information. |
    | Http Method | POST |
    [ ]

    {#import-clar-offbd-webhk-wd-hr__table_ryn_5mm_wqb}
12. Save the changes.
13. In the project explorer, select the integration and deploy it in your Workday system.
14. Log in to your Workday instance and navigate to IntegrationIntegration SystemConfigure Integration Attributes.  
15. Provide user name and password in Configure Integration Attributes that you have generated in [Generate user name and password in your ServiceNow instance for Offboarding webhook](https://www.servicenow.com/docs/7nlp~J~d7mhYF6_AhTQYjw#generate-username-pwd-offboarding-wd-hr "Generate user name and password in your ServiceNow instance to authenticate requests for Offboarding webhook and retrieve the required data from the Workday application.").  
16. Modify a business process and add this integration in your business process.
    1. Edit the definition of the business process.  
    2. Select the ISU user in Workday Account box.
    3. Select the effective date and click Ok.
    4. Click the + sign and add a new business process step in BP.
    5. Select an order, which is after the completion step of business process.
    6. Add the business process and select Type as Integration.  
    7. Provide ISU username in Run as User and click Ok.
    8. Click Configure Integration on the newly added business process step in Hire BP.  
    9. In integration criteria, select value type as Determine value at runtime and select value as Employee ID.  

       The selected Employee ID field in value is displayed.
    10. Click Ok.
    11. Open Create Custom Report task.
    12. Enter the report name, for example, enter <kbd class="ph userinput">New_terminated_record</kbd>.
    13. Select Report Type as Advanced.
    14. Uncheck the Optimized for performance option.
    15. Select Data Source as All Workers.  
    16. Create a report as shown below:  

        Group Column Headings in reports

        Sort section in reports

        Filter section in reports
    17. Select Populate Undefined Prompt defaults option from the Prompts tab.
    18. Select Enable as web service option from the Advanced tab.
    {#import-clar-offbd-webhk-wd-hr__substeps_otc_cpm_wqb}

## Set up LeaveofAbsence Webhook for the Workday HR spoke {#ariaid-title11}

Use the LeaveofAbsence Webhook to get leave of absence details of an employee from
Workday to your ServiceNow instance.

### Generate user name and password in your ServiceNow instance for
LeaveofAbsence webhook {#ariaid-title12}

Generate user name and password in your ServiceNow instance to
authenticate requests for LeaveofAbsence webhook and retrieve the required data from the Workday
application.

#### Before you begin

Role required: admin  
Note:  
These configurations must be performed in your ServiceNow instance.

#### Procedure

1. Log in to your ServiceNow instance as an admin.
2. Navigate to AllSystem DefinitionTable.
3. Filter and search for the Workday HR spoke webhook registry table, for example, Workday Webhook Registry.
4. Click the Show List related list.
5. Click New.
6. On the form, fill these values.  
   {#generate-usrnm-pwd-leave-absence-wd-hr__table_ilc_ygn_wqb__entry__2}

   | Field | Description |
   |-|-|
   | Description | Description of the webhook registry record. Enter <kbd class="ph userinput">Workday event and authentication for leave of absence</kbd>. |
   | UserName | Workday user who has integration rights using Workday Web Services. |
   | Password | Password of the Workday user. |
   | Workday Event | Event for which the webhook is set up. Enter <kbd class="ph userinput">LeaveofAbsence</kbd>. |
   | Workday Instance | Workday host URL and tenant name. Enter the URL in this format:<kbd class="ph userinput">https://&lt;workday_host_url&gt;/&lt;workday_tenant_name&gt;</kbd> |
   [ ]

   {#generate-usrnm-pwd-leave-absence-wd-hr__table_ilc_ygn_wqb}
7. Right-click the form header and click Save.
8. Click Generate UserName And Password.  
   Copy and record the values of username and password. These values must be specified in the Workday instance to authenticate the webhook requests.  
   Note:  
   If you have more than one HIRE BP in your environment, you must configure all the HIRE BPs to enable the Create User webhook for all HIRE employee transactions.

### Retrieve the resource path from your ServiceNow instance for
LeaveofAbsence webhook {#ariaid-title13}

Retrieve the resource path from your ServiceNow instance for
later use to authenticate Offboard webhook requests and retrieve the required data from the
Workday
application

#### Before you begin

Role required: admin.  
Note:  
These configurations must be performed in your ServiceNow instance.

#### Procedure

1. Log in to your ServiceNow instance as an admin.
2. Navigate to AllSystem Web ServicesScripted Web ServicesScripted REST APIs.
3. Open the record for the Workday HR spoke.
4. In the Resources tab, click the Callback record.
5. Record and save the value of Resource path for later use.

### Import CLAR file to your Workday instance for
LeaveofAbsence webhook {#ariaid-title14}

Import CLAR file available at ServiceNow Store to set up LeaveofAbsence
webhook and authenticate requests from ServiceNow
instance.

#### Before you begin

* Workday Studio should be installed.
* Access to custom report creation policy.Create custom report in workday based
  on the Leave_of_absence_request report structure and share the report with
  ISU user.

* Access to edit business process definition.
* Access to create and edit integration system.
* Role required: admin

{#import-clar-leave-absence-webhk-wd-hr__ul_rgp_mjn_wqb}  
Note:  
* Except integration name, report field XPath (if required), and Workday instance header, users are cautioned against modifying the values of fields or properties in the CLAR file.
* These configurations must be performed in Workday Studio.
{#import-clar-leave-absence-webhk-wd-hr__ul_pzk_hhq_gxb}

#### Procedure

1. From the [Workday HR spoke](https://store.servicenow.com/sn_appstore_store.do#!/store/application/133e9dacdb910010ea4494d9db961988) page on [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home), download the Workday-HR-Leave-of-Absence-Webhook-Studio-Sample file from Supporting Links and Docs.
2. Unzip the sample file to obtain the CLAR file.
3. Import the CLAR file to Workday Studio.
4. In the Properties tab of the StartHere component, navigate to Services and select the RAAS report created for this webhook.  
5. Choose the environment where your report exists such as, implementation or sandbox and configure the report as per your requirement.
6. Provide a report name and select the required report.  
7. Provide the alias name of the report.  
8. After the report alias is added, add the selected path of report in Extra Path that is used to run the report based on prompt.  
9. Select the report alias.
10. In the Set Headers component, provide your Workday instance for the WorkdayInstance header.  
11. In the properties of HttpOut, fill in these values.  
    {#import-clar-leave-absence-webhk-wd-hr__table_pp4_ykn_wqb__entry__2}

    | Field | Value |
    |-|-|
    | Endpoint | REST endpoint Note: See [Retrieve the resource path from your ServiceNow instance](https://www.servicenow.com/docs/TA~EDLj8A_RVedO1iZ~C~A#resource-path-wd-fin-spoke "Retrieve the resource path from your ServiceNow instance for later use to authenticate requests and retrieve the required data from the Workday application") for more information. |
    | Http Method | POST |
    [ ]

    {#import-clar-leave-absence-webhk-wd-hr__table_pp4_ykn_wqb}
12. Save the changes.
13. In the project explorer, select the integration and deploy it in your Workday system.
14. Log in to your Workday instance and navigate to IntegrationIntegration SystemConfigure Integration Attributes.  
15. Provide user name and password in Configure Integration Attributes that you have generated in [Generate user name and password in your ServiceNow instance for LeaveofAbsence webhook](https://www.servicenow.com/docs/7nlp~J~d7mhYF6_AhTQYjw#generate-usrnm-pwd-leave-absence-wd-hr "Generate user name and password in your ServiceNow instance to authenticate requests for LeaveofAbsence webhook and retrieve the required data from the Workday application.").  
16. Modify a business process and add this integration in your business process.
    1. Edit definition of the business process.  
    2. Select the ISU user in Workday Account box.
    3. Select the effective date and click Ok.
    4. Click the + sign and add a new business process step in BP.
    5. Select an order, which is after the completion step of business process.
    6. Add the business process and select Type as Integration.  
    7. Provide ISU username in Run as User and click Ok.
    8. Click Configure Integration on the newly added business process step in Hire BP.  
    9. In integration criteria, select value type as Determine value at runtime and select value as Employee ID.  
       Selected Employee ID field in value is displayed.
    10. Click Ok.
    11. Open Create Custom Report task.
    12. Enter the report name, for example, <kbd class="ph userinput">Leave_of_absence_request</kbd>.
    13. Select Report Type as Advanced.
    14. Uncheck the Optimized for performance option.
    15. Select Data Source as All Active and Terminated Workers.
    16. Create a report as shown below:  

        Group Column Heading section in report

        Filter section in report
    17. Select Populate Undefined Prompt defaults option from the Prompts tab.
    18. Select Enable as web service option from the Advanced tab.
    {#import-clar-leave-absence-webhk-wd-hr__substeps_krq_qln_wqb}

*[\>]: and then