Skip to main content
Docs

Add LinkedIn Open ID Connect (OIDC) as a social connection

You will learn the following:

  • Use LinkedIn OIDC to authenticate users with OAuth

Before you start

Enabling OpenID Connect (OIDC) with LinkedIn allows your users to sign up and sign in to your Clerk application with their LinkedIn account.

Configure for your development instance

For development instances, Clerk uses preconfigured shared OAuth credentials and redirect URIs — no other configuration is needed.

To configure your development instance, follow these steps:

  1. In the Clerk Dashboard, navigate to the SSO connections page.
  2. Select the Add connection button and select For all users.
  3. In the Choose provider dropdown, select LinkedIn.
  4. Select Add connection.

Configure for your production instance

In production instances, you must provide custom credentials, which involves generating your own Client ID and Client Secret using your LinkedIn Developer account.

To make the setup process easier, it's recommended to keep two browser tabs open: one for the Clerk Dashboard and one for your LinkedIn Developer Portal.

Enable LinkedIn as a social connection

  1. In the Clerk Dashboard, navigate to the SSO connections page.
  2. Select the Add connection button, and select For all users.
  3. In the Choose provider dropdown, select LinkedIn.
  4. Ensure that both Enable for sign-up and sign-in and Use custom credentials are toggled on.
  5. Save the Redirect URI somewhere secure. Keep this modal and page open.

Create a LinkedIn application

Tip

If you already have a LinkedIn app you'd like to connect to Clerk, select your app from the My apps page in the LinkedIn Developer Portal and proceed to the next step in this tutorial.

  1. On the homepage of the LinkedIn Developer Portal, select Create app. You'll be redirected to the Create an app form.
  2. Fill out the necessary information. Then, select Create app. You'll be redirected to the app's Products page.
  3. Select the Auth tab.
  4. Under Application credentials, save the Client ID and Primary Client Secret somewhere secure.
  5. Under the OAuth 2.0 settings section, next to Authorized redirect URLs for your app, select the Edit icon.
  6. Select Add redirect URL and paste the Redirect URL you copied from the Clerk Dashboard.
  7. Select Update.

Set the Client ID and Primary Client Secret in the Clerk Dashboard

  1. Navigate back to the Clerk Dashboard where the modal should still be open. Paste the Client ID and Primary Client Secret values that you saved into the respective fields.
  2. Select Add connection.

Note

If the modal or page is no longer open, navigate to the SSO connections page in the Clerk Dashboard. Select the connection. Under Use custom credentials, paste the values into their respective fields.

Enable OpenID Connect in your LinkedIn application

  1. Select the Products tab.
  2. Next to Sign In with LinkedIn using OpenID Connect, select Request access. A modal will open.
  3. Follow the instructions and select Request access.

Note

If you need to ensure the longevity of the user's access token without requiring re-authentication, consider getting approval as a Marketing Developer Platform (MDP) partner. This isn't necessary if you don't directly interact with the LinkedIn API using the access token.

Test your connection

The simplest way to test your connection is to visit your Clerk app's Account Portal, which is available for all Clerk apps out-of-the-box.

  1. In the Clerk Dashboard, navigate to the Account Portal page.
  2. Next to the Sign-in URL, select Visit. The URL should resemble:
  • For development – https://your-domain.accounts.dev/sign-in
  • For production – https://accounts.your-domain.com/sign-in
  1. Sign in with your connection's credentials.

Feedback

What did you think of this content?
Edit this page on GitHub

Last updated on