SilkRoad Logo Print topic
 

Previous Topic

Next Topic

SilkRoad Onboarding integration

To personalize the onboarding experience for the hire, SilkRoad Onboarding requires some background information before it can launch the onboarding process. If your ATS does not, or cannot track all of this information, a recruiter can supply the information in SilkRoad Onboarding.

Your ATS requests a security token from SilkRoad Onboarding to use in subsequent calls. SilkRoad Onboarding validates the security token request and makes sure the new hired employee is not a duplicate.

These are the parameters your ATS should post to SilkRoad Onboarding.

Parameter

Description

PartnerKey

A key SilkRoad gives to each partner. Points to that partner’s data in a shared database.

SharedSecret

A shared secret used, to along with the RETURN_ADDRESS, to authenticate the request.

LifesuiteCode

A code to identify the SilkRoad Onboarding customer that was entered as part of the customer configuration. SilkRoad Onboarding validates that it is pointing to the right customer to make sure there has been no misconfiguration.

Class

The class of this service that was entered as part of the configuration. Staging, Prod, Test. SilkRoad Onboarding uses this to validate it is pointed to the right class to make sure there had been no misconfiguration.

ATSName

SilkRoad Onboarding stores this so that it can be placed in the audit notes.

RecruiterName

SilkRoad Onboarding stores this so that it can be placed in the audit notes.

RecruiterID

An ID to identify the recruiter. Reserved for future use.

ATSCandidateID

ID that your ATS will use to identify the newly hired employee. This key must be immutable with respect to the newly hired employee for this job. SilkRoad Onboarding uses this ID to determine whether the employee has been already imported.

If the candidate were subsequently hired into a different job, SilkRoad Onboarding would expect a different ATSCandidateID.

SilkRoad Onboarding:

  • Returns this ID, together with the AuthenticationToken when it returns the user to your ATS.
  • Stores this ID with the employee event. SilkRoad Onboarding does not allow two events to be created with the same ATSCandidateID.

In this section

Enter SilkRoad Onboarding integration information