Linear integration
Step-by-step guide for creating a Linear OAuth app and connecting it to Delego.
Delego needs a Linear OAuth app and an active install before it can receive webhooks from your workspace. This page walks through that setup end-to-end.
Why is this manual?
Linear maintains an integration directory where third-party apps can be listed and installed with one click — but joining the directory requires going through a review process. Linear does not accept solo-engineer projects into the directory.
Because Delego is currently built and maintained by a single engineer, there is no public "Install Delego" button inside Linear. Instead, you create your own private Linear OAuth app and point it at this relay. The setup is one-time and takes about five minutes; once it's done, token refresh, webhook ingestion, and install upgrades all happen automatically.
What you'll do
- Create a Linear OAuth app in your workspace settings.
- Paste the resulting credentials into Delego's setup page.
- Click Install to authorize Delego against your workspace.
The dashboard's Linear → Setup page is your reference for the environment-specific values (callback URL, webhook URL, logo). Keep it open in another tab while you work through the steps below.
Step 1 — Create the Linear OAuth app
Open linear.app → Settings → API → OAuth applications and create a new application using the values below. The callback and webhook URLs are environment-specific — copy them from your Delego setup page exactly as shown there.
| Field | Value |
|---|---|
| Application name | Delego |
| Description | Delegate Linear issues to a local coding agent. |
| Logo | Download the 512×512 PNG from the Delego setup page and upload it here. |
| Callback URL | Copy from the Delego setup page. |
| Public | Off (unless other workspaces will install it). |
| Client credentials | Off. |
| Webhooks | On. |
| Webhook URL | Copy from the Delego setup page. |
| Webhook signing secret | Linear generates this — copy it into the credentials form in Step 2. |
| Data change events | Leave all unchecked. |
| App events | Check Agent session events. |
| Authorization events | None required. |
Save the application. Linear will show you a client ID and client secret — keep this tab open, you'll need them in the next step.
Step 2 — Paste the credentials into Delego
Switch back to Delego's Linear → Setup page and paste:
- Client ID — from your Linear OAuth app.
- Client secret — from your Linear OAuth app.
- Webhook signing secret — from your Linear OAuth app's webhook configuration.
Click Save Linear credentials. The secrets are encrypted at rest and never shown again after saving.
Step 3 — Install the Linear app
With the credentials saved, click Install on the same page. Linear walks you through the OAuth consent and redirects you back to Delego when the app is connected.
You should then see the installation listed on the setup page with a healthy status. During the consent flow, make sure to grant access to the teams where you want to use Delego. From this point on, Delego receives webhooks for delegated issues automatically.
Reconnecting later
If something changes on Linear's side — you rotate the client secret, OAuth tokens expire and a refresh fails, or you uninstall and re-add the app — the same setup page handles reconnection. It detects the existing install and offers update-credentials and re-install flows instead of starting from scratch.