Overview
This guide will walk you through how to set up third-party webhooks for Linear. After the steps in this guide are performed once, all existing and future Linear Linked Accounts will support automatic third-party webhooks.
Prerequisites
You have created your own Linear OAuth developer app
See this guide for more details
You have enabled automatic third-party webhooks in your Merge dashboard.
See our third-party webhooks guide for more details
You have created a Linear Linked Account
If you have not yet created a Linear Linked Account, you can create one through the Test Linked Accounts page in the Merge Dashboard
The Linked Account can be deleted after the below steps are performed
Steps
Step 1: Obtain the receiver URL
Log into your Merge Dashboard and find a Linear Linked Account
Navigate to the Webhooks tab of the Linked Account and click on the Issue webhook
Copy the Merge receiver URL for later use
Step 2: Configure your webhook in Linear
Log into your Linear account
Find your OAuth developer app at Settings > API and select Edit Application
Enable Webhooks
Input the Merge receiver URL you copied from Step 1 into the Webhook URL field
Toggle on the Issue and Comment webhooks
You can just enable one if you only care about one of the two
Copy the Webhook signing secret value for later use
Save the configuration
Step 3: Input the signing secret into Merge
Back in the Merge Dashboard, navigate to Integrations > Ticketing
Under the Linear integration, select Edit
Enter the Webhook signing secret from Step 2 into the Verifier Token field and Save
