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 adddoNotContact
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 addedlinkedInProfileUrl
in Request Body Fields.
May 2023
- Added new technical questions in RSC FAQ
November 2021
- Sync Candidates - New field validations added to request body fields
- Sync Applications - New field validations added to request body fields
- Sync Application Stages - New field validations added to request body fields
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
- Retrieve Recruiter Contract Seatholders - Updated query parameter
state
tostates
.
May 2021
- Closed Candidate Profiles - Time for purging a closed candidate profile updated.
April 2021
- Retrieve Recruiter Contract Seatholders - Added SeatV2 API details. Partners must migrate to new API by April 1, 2022.
- Recommended Matches - Added details of customer enablement.
- Unified Search - Added details of customer enablement.
- Integration Types - Added new
integrationTypes
for Recommended Matches and Unified Search. - Sync Applications - Added note that API is currently in development.
June 2020
- Recommended Matches - Introducing new Recommended Matches integration for RSC.
- Unified Search - Introducing new Unified Search integration for RSC.
- Development APIs now grouped into 5 Modules
- RSC FAQ - Newly introduced FAQ Wiki
- RSC Development Tools - Newly introduced Development Tools Wiki
- RSC Certification - Newly introduced Certification Section
- RSC Support Resources - Newly introduced customer support resources for Partners
- RSC Release Notes - New wiki containing RSC documentation's release notes.
- Retrieve Exported Candidates - Updated Call Volume Limit for One-Click Export
- Sync Jobs - The default value for Job Sync for Partners to be PRIVATE
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
toPRIVATE_TO_ATS_INTEGRATION
.
May 2019
- Client Credential Flow (2-legged OAuth) - Updated HTTP method to POST.
- Records Per Minute Throttle - Updated per minute throttle for batch calls to 10,000.
- InMail Stub Profiles - Updated response body fields to include
headline
andprofileUrl
. - Sync Candidates - Updated sample response with character encoding.
- Bind Customer Users - Updated reference to OAuth 2 Authorization Code flow
- Profile Plugin - Added note on member profile matching.
- Sync Applications - Added optional note requirement for resume upload.
January 2019
Sync Candidates - Updated Retrieve Candidate Matches with field projection: matchedMembers
, manualMatchedMember
.
September 2018
- Push Events - Added note that we are unable to share our IP range to validate incoming push events.
- Sync Jobs - Updated sample request job description to meet minimum character limit of 100
- Bind Customer Users - Added note that Person URN should be used to match the ATS user to Recruiter seatholders.
- Recruiter Seatholders - Added note that Person URN should be used to match the ATS user to Recruiter seatholders.
- Integration Types - Updated descriptions for Integration Configuration Keys
- InMail History - Added note that the
id
returned is a unique identifier for each InMail event. - Prospect Notes - Added note regarding timestamps and status
- Profile 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: <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
- Recruiter System Connect - Updated sample responses for endpoints which support pagination.
April 2018
- ATS Integration Configuration Plugin - Added note on widget reload for single page JS applications
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 |