By activating our integration with Workday, you can transfer Workday job requisition to approved Teamtailor requisition or to Job drafts in Teamtailor.
You can also use the 'on-hire' trigger to automatically transfer candidates from Teamtailor to Workday.
Getting started
To activate the integration, start by heading over to our Marketplace and find Workday under the category "HR systems". Once you click on the "Activate"button, you will be required to enter the following Workday credentials:
Workday API Username
Workday API Password
Workday API Tenant
Workday API Base URL
User Email: Enter one email address of a Teamtailor admin user.
Teamtailor API Key with admin read/write privileges
Please note!
1. The Workday API Base URL should end with ".../service", if the URL you receive contains more characters after that, you may remove them so it has the correct format.
2. This has to be the career site email shown on the user's Teamtailor profile, not their login email. When adding the ‘user email’ you can only provide one email.
Permissions required for the Workday API user:
In order to set this up you need to login to your Workday platform and search for the task “create integration system user".
Job Requisition Data:
Get Job Requisitions
Job Posting Data:
Get Job Postings
Candidate Data:
Put Candidates
Manage Candidate Names
Manage Candidate Contact Information
Manage Candidate Personal Information
Manage Candidate Global Personal Information
Manage Candidate Social Media Accounts
Manage Candidate Attachments
Job Application Data:
Apply Candidate to Job Requisition
Update Recruiting Stage for Candidate
Applicant Data:
Put Applicants
Manage Applicant Names
Manage Applicant Contact Information
Apply Applicant to Position
Workday Integration – Activation Form Explained
When activating the Workday integration in Teamtailor, you'll be asked to fill in some settings. Here's what each field means and how to use it:
Workday Job Requisition Integration: Check this box ✅ to synchronize your job requisitions from Workday. The inbound integration will automatically create imported requisitions as Job Drafts by default.
Workday Pre-hire Integration: Check this box ✅ when a pre-hire record is used, the newly hired individual will be transferred to Workday as an applicant.
Note: If pre-hire is not used, the Candidate end-point will be used by default.
Do you want to create a Job Requisition instead of a Job Draft?: Check this box ✅ if you want the integration to create approved job requisitions in Teamtailor instead of job drafts. By default, job requisitions are created as drafts for review before publishing.
Note: You’ll find more information on job requisition options below.Teamtailor Job Template Name: If you're syncing Workday requisitions to Teamtailor as job drafts, you can specify the name of the job template from your Teamtailor account that should be applied. You can find your job templates under Settings → Job Templates.
When configured, the selected template will be applied to all jobs created through the Workday integration.Sync Job requisition salary field: Check this box ✅ If you would like to enable salary information (salary amount, currency, and pay frequency), this data can be synchronized from Workday to Teamtailor.
Fallback Default Country
Please specify the hiring country by entering its full name (for example, Sweden).
Note: If you hire in multiple countries, you can only specify one country in this field. To support multiple countries, create a custom field in Teamtailor:
Go to Settings → Candidate Custom Fields.
Add a new Custom Field.
Configure the field as follows:
Field Type: Select
Title: Country
Options: Add the list of countries you want to make available.
Once configured, this custom field can be used to select the appropriate hiring country for each job.
Fallback Default Region:
Specify a secondary state or province to be utilized if the candidate's specific region field remains blank. This value entry is mandatory for certain locations, such as Italy.
Please utilize the standard ISO 3166-2 format (for instance, IT-MI for Milan or DE-BY for Bavaria) to ensure successful synchronization.
What does this filter do?
Filters allow you to control which requisitions are imported from Workday into Teamtailor. By defining one or more filter criteria, you can decide which requisitions should be sent from Workday, rather than importing all available requisitions.
By default, all requisitions with an Open status in Workday are imported into Teamtailor. This gives you greater control over the sync and helps ensure that only relevant requisitions are created in Teamtailor.
For example, you may choose to import only requisitions from a specific location, worker type, recruiting instruction, or custom organization assignment. Any requisitions that do not meet the selected criteria will be excluded from the import.
Filter by Location
Use this field to filter requisitions by location. Enter the Primary_Location_Reference from your Workday environment to ensure that requisitions matching that location are imported into Teamtailor.
Example: If the primary location reference for Stockholm is
Stockholm_SE, enteringStockholm_SEwill import only requisitions from that location (Stockholm) into Teamtailor..
Filter by Worker Type
Use this field to filter requisitions by worker type. This value corresponds to the Worker_Type_Reference in Workday environment.
Filter by Recruiting Instruction
Use this field to filter requisitions based on recruiting instructions. The value must match the Recruiting_Instruction_Reference configured in your Workday setup.
Filter by Custom Organization Assignment
Use this field to filter requisitions by Custom Organization Assignment. This field corresponds to the Custom_Organization_Assignment_Reference within your Workday setup.
Teamtailor API key*
To be able to connect this service an API key needs to be configured with Admin read/write permissions. If the specific key is missing from the list above, please visit API keys to generate a new one with the appropriate access level.
Job requisition integration module
The integration can automatically sync open job requisitions from Workday every hour. By default, these are synched as job drafts in Teamtailor. You need to activate this feature on the integration activation settings.
When using the requisition integration, the On-Hire workflow will automatically link the candidate to the corresponding requisition when sending data back to Workday.
You have two options with the job requisitions module:
1. Convert to Job Draft in Teamtailor
The requisition is automatically converted to a job draft in Teamtailor. You can optionally specify one job template name when activating the integration to apply a job template to the draft.
Fields mapped:
Job title
Job description
Minimum Salary
Salary Time Unit
Employment type
Template ID (if provided)
Custom fields from Workday (see table below)
No location required
No number of openings field
Workday custom fields
Please note!
To transfer Workday custom fields, you first need to create corresponding job custom fields in Teamtailor with the correct API-name.
The left column with Teamtailor job custom fields is referring to the API-name of the job custom fields that you need to create in Teamtailor. Learn more about custom fields here.
The right column with Workday Source Parth indicates which specific Workday field will be linked to the Teamtailor job custom field.
Teamtailor job custom fields | Workday Source Path | Teamtailor Field Type |
workday-job-id | wd:Job_Requisition_Reference | Text |
supervisory-organisation | wd:Supervisory_Organization_Reference.$.wd:Descriptor | Text |
company-assignment | wd:Company_Assignment_Reference.$.wd:Descriptor | Text |
cost-center | wd:Cost_Center_Assignment_Reference.$.wd:Descriptor | Text |
recruiting-start-date | wd:Recruiting_Start_Date[0] | Date |
target-hire-date | wd:Target_Hire_Date[0] | Date |
job-profile-reference | wd:Job_Profile_Reference.$.wd:Descriptor | Text |
employment-type (raw) | wd:Time_Type_Reference.$.wd:Descriptor | Text |
weekly-hours | wd:Scheduled_Weekly_Hours[0] | Number |
primary-location-reference | wd:Primary_Location_Reference.$.wd:Descriptor | Text |
pay-currency | wd:Currency_Reference.$.wd:Descriptor | Text |
pay-frequency | wd:Frequency_Reference.$.wd:Descriptor | Text |
pay-plan | wd:Pay_Plan_Reference.$.wd:Descriptor | Text |
pay-amount | wd:Amount[0] | Number |
positions-allocated | wd:Positions_Allocated[0] | Number |
positions-available | wd:Positions_Available[0] | Number |
2. Convert to Approved Requisition in Teamtailor
The requisition is added in Teamtailor’s Requisitions tab. From there, you can manually create a job. You need to activate this feature on the integration activation settings.
Fields mapped:
Job title
Job description
Number of openings
Location (taken from job's custom field: "primary-location-reference")
Salary time unit (taken from: "wd:Frequency_Reference" tag from Workday)
Min salary (taken from: "wd:Amount" tag from workday).
Please note!
For this integration module to work correctly, the location must always come from Workday (through the job’s field primary-location-reference). This is mandatory, and the location values in Workday and Teamtailor need to be exactly the same.
On-hire integration
After filling in your Workday credentials, the on-hire integration will be automatically enabled. This integration allows you to automatically transfer a newly hired person into Workday, including specified default and custom fields.
On the activation form, you can select to use the Workday 'pre-hire' feature, which will send newly hired persons to Workday as an Applicant. If pre-hire is not used (which is the default), a Candidate will be created.
By default, the following data points are transferred to Workday:
First name
Last name
Email
Phone (please see below)
Resume
How to Properly Format Phone Numbers
To format a phone number, you need to create two custom fields in Teamtailor (below) and make sure they are setup with Field Type: Select
Country Phone Code Reference (For example, SWE_46 for Sweden)
Phone Device Type Reference (For example, Work phone, Mobile phone, personal phone)
⚠️ These values must match exactly what is set up in your Workday system. Since there is no automatic way to get these through the integration, the values would need to be populated based on the values provided under your Workday instance.
How to Find the Correct Values:
In your workday account, open the report called: Country Phone Codes / Phone Device Type Reference
Find the country or phone type you want to use.
Move your mouse over it and click the three dots (...) that appear.
Click on Integration IDs → View IDs and look for the Workday ID.
Next, navigate to the Teamtailor matching candidate custom field and enter the Workday ID you copied from Workday into the corresponding custom field.
Alternatively, you can add the relevant values as choices in a Select custom field for easier management.
Mapped fields
Below is the list of additional Workday fields you can map from candidate custom fields in Teamtailor:
Please note!
To transfer candidate custom fields into Workday, you first need to create these candidate custom fields in Teamtailor with the correct API-name.
The column with Teamtailor candidate custom fields is referring to the API-name of the candidate custom fields that you need to create in Teamtailor. You also need to use correct field type. Learn more about custom fields here.
The column with Workday fields indicates which specific Workday field will be linked to the Teamtailor candidate custom field.
Workday fields | Teamtailor candidate custom fields | Teamtailor Field type |
Address_Line_1 | address-line-1 | Text |
Postal_Code | postcode | Text |
City | city | Text |
Ethnicity_Reference | ethnicity-reference | Text |
Veterans_Status_Reference | veteran-status-reference | Text |
Hispanic_or_Latino | hispanic-or-latino | Select: Yes / No |
Disability_Status_Reference | disability-status-reference | Text |
Gender_Reference | gender | Text |
Date_of_Birth | date-of-birth | Date |
Birth_Country_Reference | birth-country-reference | Text |
Birth_Region_Reference | birth-region-reference | Text |
City_of_Birth | city-of-birth | Text |
Marital_Status_Reference | martial-status-reference | Text |
Ethnicity_Reference | ethnicity-reference | Text |
Religion_Reference | religion-reference | Text |
Citizenship_Reference | citizenship-reference | Text |
Nationality_Reference | nationality-reference | Text |
Additional_Nationality_Reference | additional-nationality-reference | Text |
Social_Benefits_Locality_Reference | social-benefits-locality-reference | Text |
LGBT_Identification_Reference | lgbt-identification-reference | Text |
Sexual_Orientation_Reference | sexual-orientation-reference | Text |
Gender_Identity_Reference | gender-identity-reference | Text |
Pronoun_Reference | pronoun-reference | Text |
Country_Phone_Code_Reference
| country-phone-code-reference | Text/Select |
Phone_Device_Type_Reference | phone-device-type-reference | Text/Select |
Stage mapping
To transfer the candidate into a specific stage in Workday you can create a custom field in Teamtailor, and fill this field with the name of the Workday stage, e.g. Review, Offer, Employment Contract. To do this you can either create the candidate custom field with the title/api name 'stage' or the job custom field 'job-stage')
Workflow within Teamtailor
You can set up the Workday trigger in a job and send your new hires data automatically to the Workday job requisition when a candidate is moved into the chosen stage.
To add a trigger:
Click on the triggers tab under applications in a chosen Job.
Go to a stage where you want the event to happen.
Click the plus button + to add the trigger.
Now, every time you move a candidate to this stage, it will tell the Teamtailor application to send their information to your "Employment Agreement" section.
You will also see that the candidate card in Teamtailor now has a status of "Sent" under the name Workday.
Note: If you have chosen not to have the job requisition integration enabled, upon setting up the trigger, it will render a drop-down list of job requisitions inside of Workday to match with.
FAQ
1. What is created in Workday with the Candidate option?
With the candidate option, we create the Candidate in the Workday Recruitment module, API reference.
2. What is created with the Applicant / pre-hire option?
With the pre-hire option, we create a pre-hire (previously called applicant) in the Workday HCM Core module, API reference.
3. In which cases is the person automatically linked to the correct Job Requisition?
For candidates, they are linked to the Requisition ID directly. For Applicant, we extract a valid Position ID from the requisition and link them to that rather than the Requisition itself.
4. Does this depend on the customer’s Workday configuration, or on whether the requisition originally came from Workday into Teamtailor?
The synchronization depends primarily on whether the job requisition information is available in Teamtailor. If the Job Requisition Integration is enabled, the required requisition data is populated automatically. If the integration is not used, the requisition ID must be entered manually in the appropriate custom field for each job; otherwise, the system cannot automatically associate the person with the correct requisition.
Still need help?
Contact Teamtailor directly by:
Chat: open your Teamtailor app and chat live.
Visiting our help centre: https://support.teamtailor.com/en
Email: support@teamtailor.com
Phone: +46 (0)10 330 22 22





