Umantis Applicant Management includes an interface to LinkedIn, and can make the application process easier for the applicant. This interface allows an applicant to copy over their own résumé data directly from their LinkedIn profile. The umantis system can also download their data from LinkedIn and then upload the generated résumé to the application form. This interface can be used for both the internal job board and the external job board.
Since mobile devices (e.g. cell phones and tablets) do not always provide a file system that can be used to upload files, the URL to the applicant’s public profile is also added to the application. This allows the HR expert to access the applicant’s résumé data directly from inside umantis.
Set up LinkedIn interface
The LinkedIn interface settings can be accessed under:
- “Settings > Interfaces > Settings for LinkedIn interface”
- (Alternatively, you can navigate directly to the settings with the URL ending "/Administration/Interfaces/LinkedInSettings".)
In order to use the LinkedIn interface and allow applicants to apply through their LinkedIn profile, a software application must first be set up directly in LinkedIn. You will then take the API and secret keys that are generated in that process and enter them directly in the corresponding fields in umantis Applicant Management. Be sure to follow the guidelines in the section on Approval and validity of your LinkedIn API key.
Step-by-step instructions to set up the LinkedIn interface:
- First, sign in to https://www.linkedin.com/secure/developer with your LinkedIn account.
If you are not yet a LinkedIn member, please register now, since only registered members can set up the interface.
- Click on “Set up application” in the overview of software applications.
- A form will then open in which you must fill out individual fields. Be sure to follow the guidelines (under the figure):
- Company name:
- Enter the company name here.
- Each user that uses the LinkedIn interface for an application sees this name in the request to release data for this umantis interface. Therefore, you should preferably provide the same company name that is used by umantis Applicant Management. 50-character maximum.
- Please describe your software application. 2,000-character maximum.
- URL for application logo:
- Please provide a secure (https) URL for your application logo image in PNG or JPG format. For optimal quality, the image size should be 80 x 80 pixels. The build can then be seen by users of this interface.
- Purpose of the application:
- Please enter the purpose of your application (e.g. "Jobs and Recruiting")
- Web site URL:
- Please enter a URL that leads to additional information about this application.
- Business email:
- Please enter the business email address of a person who is responsible for this application.
- Business phone:
- Please enter the business telephone number of a person who is responsible for this application.
- You must then read the LinkedIn API Conditions of Use and confirm them by checking a box.
- You will then be redirected to the “Authentication key” page. Ensure that only the following boxes are checked on this page:
- You can see both “Customer ID” and “Customer secret” on this screen.
- Copy these fields over to your umantis solution:
- In umantis (under /Administration/Interfaces/LinkedInSettings), enter the “Customer ID” (in umantis = “API key”) and the “Customer secret” (in umantis = “Secret key”).
- Click “Save”. When saving is complete, you will see a message indicating whether the LinkedIn interface has been set up correctly, or whether any problems occurred during setup.
- You may see any of the following messages here:
- LinkedInAPICall200: LinkedIn API: 200 OK — The LinkedIn API (application program interface) can be reached with the API keys that were provided.
- errorLinkedInAPICall403: LinkedIn API: 403 Forbidden — Missing permissions, e.g. r_fullprofile or r_contactinfo.
- errorLinkedInAPICall500: LinkedIn API: 500 Read timeout: The most likely reason for this error message is that the API key is invalid or the LinkedIn server cannot be reached.
- On the application form (/Vacancies/ID/Application/New), switch to configuration mode and enable the LinkedIn option (i.e. the link to “Copy data from my LinkedIn profile”) for display.
Then check that everything is working correctly by logging out of umantis and opening a vacancy from your job board. Next, click on the “Copy data from my LinkedIn profile” link that is now visible in the application form. If everything has been set up correctly, LinkedIn will now ask you to release your data for use in the application.
Approval and validity of your LinkedIn API key
- Please note that your LinkedIn API key must be approved by LinkedIn.
- To do this, please provide your company name and your LinkedIn API key directly to our Customer Service team: Send email to Customer Service (firstname.lastname@example.org).
- The API key is valid for 599 days and must be renewed through LinkedIn as needed.
Enabling the LinkedIn fields for display in the application form
Once the interface has been set up, you can use configuration mode in your Applicant Management system to enable the function for display on the following pages:
- External job board:
- in the appropriate forms (as previously)
- Internal job board:
- /Vacancies/ID/Application/New/ID (previously)
- Unsolicited applications:
The link to “Generate CV from my LinkedIn profile profile” can also be enabled for display in the application form. This link can be found below, and allows applicants to generate a CV/résumé from their LinkedIn profile.
Data copied over
The following document lists all relevant résumé fields that are transferred from LinkedIn to umantis: LinkedIn template (German & English)