# Prerequisites in Workday (WIP)

### Findem <> Workday Setup

You can connect your Workday account with Findem by following these steps:

[**Step 1**](#step-1-create-a-new-isu-account-in-workday-for-your-findem-integration)**:** Create a new ISU account in Workday for Findem

**Step 2:** Create a new Security Group (Unconstrained)&#x20;

**Step 3:** Add the ISU account to the security group

[**Step 4**](#step-4-update-required-api-permissions)**:** Add permissions to a security group

**Step 5:** Activate Security Changes

[**Step 6**](#step-6-get-the-service-endpoint-name)**:** Collect your service endpoint

[**Step 7**](#step-7-copy-your-tenant-name)**:** Collect your tenant name

\--

### **Step 1: Create a new ISU account in Workday for your Findem integration**

* [ ] Login to Workday, search for *Create Integration System User*, and run the task.
* [ ] Enter a user name and password. Uncheck the box *Require New Password at Next Sign In.*
* [ ] Ensure that [<mark style="color:orange;">Session Timeout Minutes</mark>](#user-content-fn-1)[^1] is set to 0.
* [ ] Click OK to create the new user.

<figure><img src="https://2002240509-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTjfPx6VG2r5fA5D4vqus%2Fuploads%2Fu73W6jrFPJT9ZjFbJJgw%2Fimage.png?alt=media&#x26;token=f2fd599a-e4d1-42e4-a316-7dff8bd629cd" alt=""><figcaption></figcaption></figure>

* You will need to retrieve the Organization ID and Service Endpoint from Workday.

  * Log in to Workday with a user that has access to the “*Public Web Services*” report (the task, *View Security for Securable Item* can help you which groups have access to this report).
  * Search for “*Public Web Services*” in the search bar and click on the corresponding report.

<figure><img src="https://2002240509-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTjfPx6VG2r5fA5D4vqus%2Fuploads%2FZpVLJuUXnVg118EvJ2B5%2Fimage.png?alt=media&#x26;token=ffa04ef3-0f3b-4536-98a9-2546bde931b9" alt=""><figcaption></figcaption></figure>

* Click on “*Web Service”* and “*View WSDL”* under the Recruiting (Public) Web Service.

<figure><img src="https://2002240509-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTjfPx6VG2r5fA5D4vqus%2Fuploads%2FM3I7zA7aU4TkMssVHJdD%2Fimage.png?alt=media&#x26;token=8d4b948f-baf3-448d-852d-991afd6d171e" alt=""><figcaption></figcaption></figure>

### Step 4: Update Required API Permissions

For reference, please see the Recruiting section in Workday’s Soap API.&#x20;

<https://community.workday.com/sites/default/files/file-hosting/productionapi/Recruiting/v39.1/Recruiting.html>

| REQUEST                                                                                                                                                                      | DOMAIN SECURITY POLICY (required permissions)                                                                                                                                                                                                                                                                                                                                                              |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><strong>Get\_Workers</strong></p><p><br></p><p>This request is used to map recruiters within Workday to users of the Findem Platform.</p>                                 | <p><strong>Worker First Name</strong></p><p>Worker\_Data.Personal\_Data.Name\_Data.Legal\_Name\_Data.Name\_Detail\_Data.First\_Name</p><p><br></p><p><strong>Worker Last Name</strong></p><p>Worker\_Data.Personal\_Data.Name\_Data.Legal\_Name\_Data.Name\_Detail\_Data.Last Name</p><p><br></p><p><strong>Worker Email</strong></p><p>Worker\_Data.Personal\_Data.Contact\_Data.Email\_Address\_Data</p> |
| <p><strong>Get\_Candidates</strong></p><p><br></p><p>This request is used to retrieve candidate data and enrich Findem’s enriched candidate profile.</p>                     | <p>Candidate Data: Candidate\_Name\_Data</p><p>Candidate Data: Candidate\_Contact\_Data</p><p>Candidate Data: Social\_Media\_Account\_Data</p><p>Candidate Data: Job Application</p><p>Candidate Data: Candidate\_Status\_Data</p><p>Candidate Data: Candidate\_Tag\_Reference</p>                                                                                                                         |
| <p><strong>Get\_Candidate\_Attachments</strong></p><p><br></p><p>This request is used to retrieve candidate data and enrich Findem’s enriched candidate profile.</p>         | Candidate Data: Attachments                                                                                                                                                                                                                                                                                                                                                                                |
| <p><strong>Get\_Job\_Requisitions</strong></p><p><br></p><p>This request is used to link a job requisition to a Findem Search.</p>                                           | Job Requisition Data                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><strong>Get\_Job\_Postings</strong></p><p><br></p><p>This request is used to identify open jobs available via the job board. </p>                                         | Job Postings: External                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><strong>Put\_Candidate</strong></p><p><br></p><p>This request is used to export candidates from Findem either as a prospect or to a job requisition as an applicant. </p> | Candidate Data: Job Application                                                                                                                                                                                                                                                                                                                                                                            |

### **Step 6: Get the Service Endpoint name**

In your Workday account, search for Public Web Services and view the report. Scroll down and click the three dots next to Recruiting: Public, then select *Web Service > View WSDL*. A new tab will open with an XML file.

Using the Find feature in your browser (press Ctrl + F if you are using Windows, or Cmd + F on a Mac), search for *soapbind:address*, the URL will contain the service endpoint.&#x20;

*`Example`*`: https://wd-2impl-services1.workday.com/`

### **Step 7: Copy your Tenant name**

Your tenant name is part of your url when you’re logged into Workday. This is present in the URL as&#x20;

*`Example`*`: https://impl.workday.com/`**`tenant_name`**`/d/home.htlmd`

\ <br>

[^1]: