Recruiter System Connect (RSC) - Announcements & Release Notes

March 2024 -- Updates to atsCandidates

  • Updated Sync Candidates to indicate that the firstName field is required Updated Sync Candidates to add doNotContact field Updated Sync Candidates updated phone number and address fields to indicate they are required but can be empty
  • Changed Stubprofile emailAddress field lists array of email to type string.

October 2023 -- One Click Export Limits

  • Limits for One Click Export updated to 300 requests per month per seat.

July 2023 Minor Updates

  • Updated Retrieving Closed Candidate Profiles documentation to describe expected partner behavior: Our ATS partners must query this endpoint periodically (at least once in 30 days) and notify end customers that they may need to delete the data that appear within this endpoint from their records if they do not have a legal basis to continue processing it.

June 2023

  • Sync Candidates - Updated description for externalProfileUrl and added linkedInProfileUrl in Request Body Fields.

May 2023

  • Added new technical questions in RSC FAQ

November 2021

A consolidated summary of the new validation changes is below.

Sync Candidates

Endpoint Field Type New validation(s)
/atsCandidates atsCreatedAt Integer Value must be greater than 0
/atsCandidates atsLastModifiedAt Integer Value must be greater than 0
Value must be greater than or equal to atsCreatedAt
/atsCandidates emailAddresses String[] Emails must follow X@X.X pattern

Sync Applications

Endpoint Field Type New validation(s)
/atsApplications atsCreatedAt Integer Value must be greater than 0
/atsApplications atsLastModifiedAt Integer Value must be greater than 0
Value must be greater than or equal to atsCreatedAt
/atsApplications atsJobPostingId String Min. length: 1
/atsApplications atsJobPostingName String Min. length: 1
/atsApplications candidateEmail String Email must follow X@X.X pattern
/atsApplications firstName String Min. length: 1
/atsApplications lastName String Min. length: 1
/atsApplications source String Min. length: 1

Sync Application Stages

Endpoint Field Type New validation(s)
/atsApplications/{atsJobApplicationId}/stages atsCreatedAt Integer Value must be greater than 0
/atsApplications/{atsJobApplicationId}/stages stage String Min. length: 1
Value cannot be "Not Available"

June 2021

May 2021

April 2021

June 2020

April 2020

  • Added Required Fields table for all Recruiter System Connect APIs.
  • Prospect Notes - Added push event type of DELETE_PROSPECT_NOTE to process customer deleted Recruiter notes.
  • Sync Jobs - Added note on how to update job posting from PUBLIC to PRIVATE_TO_ATS_INTEGRATION.

May 2019

January 2019

Sync Candidates - Updated Retrieve Candidate Matches with field projection: matchedMembers, manualMatchedMember.

September 2018

<script type="text/javascript" src="https://platform.linkedin.com/xdoor/scripts/in.js">
  api_key: <enter api key here>
  extensions: HcmWidget@https://www.linkedin.com/recruiter/widget/hcm
</script>

Customer Configuration Plugin - Updated references from "https://www.linkedin.com/uas/in.js" to "https://platform.linkedin.com/xdoor/scripts/in.js". Example of the change below:

<script type="text/javascript" src="https://platform.linkedin.com/xdoor/scripts/in.js">
  api_key: {customer app API key goes here}
  extensions: ATSIntegrationWidget@https://platform.linkedin.com/rsc/extensions/onboarding-widget
</script>

August 2018

  • InMail History - Removed note that InMail content is only visible to the sender/receiver of the particular InMail.

June 2018

April 2018

March 2018

  • Referrals - Updated communication that we are no longer accepting new LinkedIn Referrals integrations
  • InMail History - Added note that InMail content is only visible to the sender/receiver of the particular InMail.
  • Profile Plugin - Added callback function for linking and unlinking profiles. See example below:
<script type="text/javascript" src="https://www.linkedin.com/uas/in.js">
  api_key: <enter api key here>
  extensions: HcmWidget@https://www.linkedin.com/recruiter/widget/hcm
</script>

<script type="IN/HcmWidget"
  data-widget-type="ATS"
  data-ats-candidate-id="{your unique candidate id}"
  data-integration-context="{customer's integration context URN}"
  data-show-unlink-url="{true|false}"
  data-confirm-unlink="{true|false}"
  data-onlink="link"
  data-onunlink="unlink"  
  data-width="{Width}">
</script>

<script>
  function link(profile) {
     console.log("Link callback", memberToken);
  }
  function unlink(profile) {
     console.log("Unlink callback", memberToken);
  }
</script>
  • Records Per Minute Throttle - In addition to our daily call limits we have a per minute throttle applied to batch calls. See example below:
Throttle Limits Requests Per Day (UTC) Records Per Minute
Application maximum 100,000 2,000