Recruiter System Connect - Required Fields
To ensure a consistent experience for customers using Recruiter System Connect below are the fields required to sync per category.
Note
- LinkedIn strictly audits partner behavior to ensure good user experience. If required fields are not available in your ATS system, instead of sending incorrect values, we strongly suggest you get in touch with your LinkedIn Business Development point of contact and inform them.
| Category | Field | Description | Format | Required |
|---|---|---|---|---|
| Sync Jobs | integrationContext | Organization this job posting is created for. Must be in the format urn:li:organization:1234 |
URN | Yes |
| Sync Jobs | externalJobPostingId | Unique job id within the applicant tracking system. | String | Yes |
| Sync Jobs | title | Title of this job posting | String (Max 200 Characters) | Yes |
| Sync Jobs | description | Custom description of the job posting. | String | Yes |
| Sync Jobs | location | Geographic location of the job position. Must be in the format "CITY,STATE" or "CITY,COUNTRY". | String | Only if countryCode and postalCode are not provided |
| Sync Jobs | countryCode | Country code of the job position. | String | Only if location is not provided |
| Sync Jobs | postalCode | Postal code of the job position. | String | Only if location is not provided |
| Sync Jobs | state | Defines the current state of the job. Must be either "LISTED" or "CLOSED". | String | Yes |
| Sync Jobs | companyApplyUrl | Where to redirect applicants to in order to apply for the job. | String | Yes |
| Sync Jobs | listedAt | Date job posting was added to partner's system. | Epoch in Milliseconds (UTC) | Yes |
| Sync Candidates | atsCreatedAt | Date record was created in your ATS | UTC Epoch Milliseconds | Yes |
| Sync Candidates | atsLastModifiedAt | Date record was last updated in your ATS | UTC Epoch Milliseconds | Yes |
| Sync Candidates | emailAddresses | List of candidate email addresses. | Array of email addresses | Yes, if no Person URN |
| Sync Candidates | externalProfileUrl | Link to the candidate in your system | String | Yes |
| Sync Candidates | firstName | Candidate's first name | String | Yes |
| Sync Candidates | lastName | Candidate's last name | String | Yes |
| Sync Candidates | manualMatchedMember | LinkedIn Person URN received from One-Click Export. | Person URN | Yes, if no email address |
| Sync Applications | atsCandidateId | Candidate's unique identifier in your ATS | String | Yes, if data is available. |
| Sync Applications | atsCreatedAt | Date record was created in your ATS | UTC Epoch Milliseconds | Yes |
| Sync Applications | atsLastModifiedAt | Date record was last updated in your ATS | UTC Epoch Milliseconds | Yes |
| Sync Applications | atsJobPostingId | Unique identifier in your ATS of the job being applied to. | String | Yes |
| Sync Applications | atsJobPostingName | Name in your ATS of the job being applied to. | String | Yes |
| Sync Applications | candidateEmail | Candidate email addresses as entered on the application | EmailAddress | Yes |
| Sync Applications | dispositionReason | Indicates the reason the candidate was not hired. | String | Yes, if data is available. |
| Sync Applications | firstName | Candidate's first name as entered on the application | String | Yes |
| Sync Applications | lastName | Candidate's last name as entered on the application | String | Yes |
| Sync Applications | source | Where the application originated within your ATS. For example, "Monster", "Referral", or "Career Fair". | String | Yes |
| Sync Applications | media | The media urn of the resume you uploaded in step b). Note that this token will expire 24 hours after it is obtained. | Media URN | Yes, if resume is being sent |
| Sync Application Stages | atsCreatedAt | Date record was created in your ATS | UTC Epoch Milliseconds | Yes |
| Sync Application Stages | stage | Stage in which the application stayed supplied by external ATS (e.g. Phone Screen, Onsite Interview, Rejected, Hired, etc.). | String | Yes |