Linear - How do I set up my partner credentials?

Last updated: May 31, 2025

Overview

Rather than use Merge's Linear developer app to connect to your customers' Linear account, you may want to set up your own Linear developer app. The below steps will take you through the required process:

Instructions

Step 1: Create a Linear Developer App

If you already have a Linear account you may skip the first step, below. You may want to consider using a Linear workspace dedicated to managing the developer app, as each admin user of the workspace will have access.

  1. Begin creating a Linear account through the Linear sign up form

    1. Note that proceeding with these steps will create a free Linear account. This is required to create a developer app, but you do not need to use the account

  2. After signing up, create a new workspace

  3. After continuing through the Get Started steps, navigate to the workspace Settings

  4. Under Administration > API add a New OAuth application

  5. Populate the Create new application form and click Create. Be sure to set the below values:

    1. Callback URLs: https://app.merge.dev/oauth/callback

    2. Public: Ensure this is toggled on

    3. Note, if you'd like to set up third-party webhooks, follow this guide 📄 Linear - How do I set up third-party webhooks?

  6. Copy your Client Id and Signing secret

Step 2: Populate your app's details within Merge

  1. Navigate to the Integrations > Ticketing page in the Merge dashboard

  2. Expand the Linear integration and select Edit

  3. Populate your credentials:

    1. OAuth Client Id: Your Client Id from the first step

    2. OAuth Client Secret: Your Signing secret from the first step

    3. Redirect URI: https://app.merge.dev/oauth/callback