Docs

Add Linear as a social connection

You will learn the following:

  • Use Linear to authenticate users with OAuth

Before you start

Enabling OAuth with Linear allows your users to sign up and sign in to your Clerk app with their Linear account.

Important

You must be a workspace admin to create and manage OAuth apps in Linear.

Configure for your development instance

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

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

Configure for your production instance

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

To make the setup process easier, it's recommended to keep two browser tabs open: one for your Clerk Dashboard and one for your Linear's API settings page.

Enable Linear as a social connection in Clerk

  1. In the Clerk Dashboard, navigate to the SSO connections page.
  2. Select Add connection and select For all users.
  3. In the Choose provider dropdown, select Linear.
  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 the modal and page open.

Create a Linear app

  1. In the top-left of Linear, select your workspace, then select Preferences.
  2. In the sidebar, under My Account, select API. Scroll down to OAuth Applications and select Create new OAuth Application. You'll be navigated to the Create new application page.
  3. Complete the required fields. In Callback URLs, paste the Redirect URI you saved from the Clerk Dashboard.
  4. Select Save. The page will refresh and you should see the Client ID and Client Secret at the top. Save both values somewhere secure.

Set the Client ID and Client Secret in your Clerk Dashboard

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

Note

If the modal or page is not still open, navigate to the SSO connections page in the Clerk Dashboard. Select the Linear connection. Under Use custom credentials, you can paste the Client ID and Client Secret into their respective fields.

Test your OAuth

The simplest way to test your OAuth 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 Linear account.

Feedback

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

Last updated on