Enable Job Distribution Connector
To enable the Job Distribution Connector integration, the client administrator must perform the actions listed below. The activation of the integration is a one-time activity.
Technical Documentation Resources
Technical documentation for developing the integration is available in API Explorer via the following navigation:
- . Select Job Distribution Connector in the drop-down at the top-left of the page.
For administrators configuring the integration, an integration guide is available at the following locations:
- Navigate to .
- Click the Job Distribution Connector tile.
- Click .
- Enter your job distribution provider information.
- Click .
- Click . This opens the Settings page for the integration.
- Enter your Username. This is the user name provided by your vendor/development partner to authenticate the request from Cornerstone Recruiting to the job distribution provider.
- Enter your Password. This is the password provided by your vendor/development partner to authenticate the request from Cornerstone Recruiting to the job distribution provider.
- Enter your Secret Key. Cornerstone uses your secret key to encrypt the password and user token before it is sent to the job distribution vendor. You will need to share the same secret key with the vendor/development partner who in turn will use the key to decrypt the password and token received from Cornerstone.
- Enter your job distribution vendor’s name in the Vendor Name field. Recruiters will see the value you enter here on the Job Posting page. If you do not enter a value, Cornerstone will display the default value of "Job Distribution."
- Enter the BaseServiceURL. This is the base URL endpoint for all the job distribution webhooks. This is provided by your vendor/development team.
- In the "Vendor Supports..." section below BaseServiceURL, you can enable or disable the Edit, Repost, Delete, and Delete All actions based on the actions supported by your vendor. Enable or disable by using the toggle for each action. The color of the action changes to black when the action is enabled.
- The Field Configuration section shows the list of available fields that Cornerstone may send to your job distribution provider when a user posts a job from Cornerstone to the vendor’s portal. Select the fields by turning on the toggle switch. Share the list of selected fields to your vendor/development partner to inform them of the fields that they can expect to be included in the job distribution request from Cornerstone. Note: Your vendor/development partner must be notified before you make any changes to the selected fields. This is to ensure that the integration does not break. This will allow the vendor to make the necessary changes, if needed.
- Click . This directs you to the Manage Users tab for the integration in Edge.
From this page, you can provide a mapping between your users’ Cornerstone User ID and their credentials on the vendor’s portal. This allows your users to navigate seamlessly from Cornerstone to the vendor’s portal while creating, editing, or reposting a job.
Depending on the vendor’s implementation, you will need to provide your users’ password or token or both from the vendor’s system. All users who will be creating and managing job postings from Cornerstone to your job distribution vendor must already have an account with the vendor and must be listed on this page. If a user who is not listed on this page attempts to post a job, they will see an error message on the Job Posting page in Cornerstone.
To add users:
- Click . This enables the user fields to display.
- Enter the Cornerstone User ID. This is the user’s user ID in your Cornerstone portal.
- Enter the Vendor User. This is the user’s user ID in the vendor's portal.
- Enter the Vendor Password. This is the user’s password in the vendor's portal.
- Enter the Vendor Token. This is the user’s token in the vendor’s portal. This token is usually issued by vendors to facilitate single sign on (SSO) from Cornerstone to the vendor’s portal.
- Toggle the Active option to on to activate the user. Toggle the option to off to deactivate the user. Deactivating a record on this page does not deactivate the user’s account in Cornerstone or in the vendor’s site.
- Click to save the information.
You can edit a user by clicking the edit icon in the Modify column.