Integrations
Linear
How to connect Linear to Nova Admin via OAuth.
Create a Linear OAuth application to connect. Enter your Client ID and Client Secret, then authorize.
How OAuth connection works
Linear uses OAuth 2.0. Nova Admin stores an access/refresh token pair on your behalf — your password is never stored.
Prerequisites
Before clicking Authorize, complete these setup steps:
- Go to Linear Settings → API → Applications and create (or edit) an OAuth app
- Set the Redirect URI to: {{callbackUrl}}
- Copy the Client ID and Client Secret into the fields below
- Under Webhooks, set the URL to: {{webhookUrl}} and enable Agent Session events
- Copy the Webhook Signing Secret into the field below, then click Authorize
Credential fields
| Field | Required | Notes |
|---|---|---|
| Client ID | Yes | Linear OAuth App Client ID |
| Client Secret | Yes | Secret — stored encrypted. |
Connect
In Nova Admin, go to /agents/integrations, find Linear, enter the OAuth credentials above, and click Authorize. You will be redirected to Linear to grant access, then back to Nova Admin.
Troubleshooting
- Redirect URI mismatch: ensure the OAuth app's redirect URI exactly matches the callback URL shown in the connect dialog.
- Scopes error: verify your OAuth app has the scopes listed above enabled.
- Need help?: refer to the Linear OAuth docs.