Go to the Destinations overview page and click the Add destination button. Select Workday and click Continue. You can then authenticate Hightouch to Workday by entering the following required fields into Hightouch:
Hostname
Tenant ID
Username
Password
The hostname is the hostname of the Workday SOAP endpoints you want to use.
You only need to enter the hostname, without https:// nor particular endpoint URL.
For example, if you want to use this SOAP endpoint: https://wd2-impl-services1.workday.com/ccx/service/your_company/Human_Resources/v40.1,
enter wd2-impl-services1.workday.com.
If you don't have a hostname, enter wd2-impl-services1.workday.com.
You can find your tenant ID from your URL when you are logged into Workday.
For example, if the URL is https://impl.workday.com/your_company/d/home.html, then your tenant ID is your_company.
Workday recommends that you use Integrated System User (ISU) to when connecting to Workday via third-party services like Hightouch.
See Workday's docs for more information on setting up an ISU.
Once you've set up your Workday destination and have a model to pull data from, you can set up your sync configuration to begin syncing data. Go to the Syncs overview page and click the Add sync button to begin. Then, select the relevant model and the Workday destination you want to sync to.
This sync type adds new organizations and/or updates existing organizations with the supplied information.
A new effective-dated organization name is automatically created if any attributes used for organization name are different as of specified effective date.
To use this sync type, you need to have Put access for the Manage: Organization Update Integration domain.
Hightouch lets you sync organization fields via field mapping.
You can map data from any of your model columns to the default organization fields.
Ensure your model columns data types match the data types of the fields you want to sync to.
To match rows from your model to worker in Workday, you need to select a model column and corresponding Workday field. You can match on any of the following Workday fields:
Universal_ID_Reference
Person_Reference
When matching with Universal_ID_Reference, you must also specify its Reference Type int the attributes mapping. Valid values are:
WID
Universal_Identifier_ID
When matching on Person_Reference, you must also specify its Reference Type in the attributes mapping.
See the RoleObject's @type for the full list of valid values.
You can map data from any of your model columns to these fields. Ensure your model columns data types match the data types of the fields you want to sync to.
To match rows from your model to position in Workday, you need to select a model column and corresponding Workday field. You can match on any of the following Workday fields:
Hightouch lets you sync position fields via field mapping.
You can map data from any of your model columns to the default position fields.
Ensure your model columns data types match the data types of the fields you want to sync to.
This error means your Workday user doesn't have enough permission to perform the API operation configured in the Hightouch sync.
You can resolve the error by granting the user you authenticated with with the permission required for the endpoint.
For example, if you get this error when you're trying to make changes with the Change_Home_Contact_Information endpoint, you should ensure your user has permission to use this API.
Hightouch provides complete visibility into the API calls made during each of your sync runs. We recommend reading our article on debugging tips and tricks to learn more.