LinkedIn

Connect LinkedIn to publish jobs and receive applications in InsightHire.

Connect LinkedIn so your team can publish InsightHire positions on LinkedIn and bring supported LinkedIn applications into the correct position in InsightHire.

Before you begin

You need:

1. An InsightHire Org Admin account.
2. Approval through the LinkedIn Talent Solutions partner program.
3. A LinkedIn Developer App with a Client ID and Client Secret. These identify your LinkedIn app and should be treated like a username and password.
4. Your company's numeric LinkedIn organization ID. Enter only the number, without the LinkedIn organization prefix.

A standard “Sign in with LinkedIn” app does not provide access to LinkedIn recruiting products. LinkedIn must approve the relevant Talent Solutions products before job posting or Apply Connect can work.

Connect LinkedIn

1. In InsightHire, open Settings → Integrations.
2. Select LinkedIn.
3. Choose Client credentials only unless InsightHire or LinkedIn has specifically told you to use member authorization.
4. Enter the Client ID, Client Secret, and numeric organization ID.
5. Add a poster email if your setup requests one.
6. Select Connect or Save.
7. Use the connection test shown on the page.

Client credentials are recommended for most approved partner setups. Member authorization is optional and only works when LinkedIn has granted the required permissions to your app. If LinkedIn reports that no permissions are available, use client credentials and confirm your partner approval.

Set up application delivery

Apply Connect is LinkedIn's service for sending job applications to an approved recruiting partner.

1. Open the LinkedIn setup page in InsightHire.
2. Copy the application delivery address shown there.
3. In your LinkedIn Apply Connect configuration, add that address as the job application webhook URL.
4. Complete LinkedIn's ownership check.
5. Submit a test application and confirm it appears under the expected position in InsightHire.

Do not reuse or alter the address shown by InsightHire. Applications can only be matched reliably when the LinkedIn job uses the same position reference that was used when the job was published.

Publish and manage jobs

After the connection succeeds, open an InsightHire position and use its LinkedIn publishing action. Depending on your LinkedIn approval, your team may be able to:

• publish a new job;
• update the title, description, or location;
• close a listing; or
• renew an expired listing.

LinkedIn controls product access. A successful connection does not guarantee that every publishing or application feature is approved for your company.

Candidate status and results

For supported partner configurations, InsightHire can send candidate status changes and completed screening results back to LinkedIn. Availability depends on the LinkedIn products approved for your app and the options enabled for your organization.

Confirm this behavior with a test candidate before relying on it in a live hiring process.

Troubleshooting

LinkedIn says the app is unauthorized

Confirm that LinkedIn approved the relevant Talent Solutions product. Reconnecting cannot add permissions that LinkedIn has not granted.

The connection test fails

Re-enter the Client ID and Client Secret, confirm the organization ID belongs to the correct LinkedIn company page, and reconnect.

An application does not appear

Confirm that the LinkedIn job was published or mapped to the intended InsightHire position and that the application delivery address matches the one shown in InsightHire.

A job publishes but results do not return to LinkedIn

Result sharing requires separate LinkedIn product access. Ask your LinkedIn representative which capabilities are enabled for your app.

LinkedIn documentation

• LinkedIn Talent Solutions documentation
• Apply Connect: receive applications