Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

next
md 30 lines 1.91 KB
Rendered Raw
1 ## How do I set up custom OAuth credentials for Linear?
2
3 Use your own Linear OAuth application when you want users to see your app's name on the consent screen and control the credentials yourself.
4
5 ### Create the Linear app
6
7 1. Sign in to [Linear](https://linear.app/) and open your workspace's [API settings](https://linear.app/settings/api).
8 2. Create a new OAuth application and give it a name.
9
10 ![Linear API settings page with the New OAuth application button](/images/toolkits/linear/api-settings.webp)
11 3. In **Callback URLs**, enter `https://backend.composio.dev/api/v1/auth-apps/add`. It must exactly match the `oauth_redirect_uri` field in your Composio auth config.
12 4. Fill in the remaining required fields and create the application.
13 5. On the application page that opens, copy the **Client ID** and **Client Secret**.
14
15 ### Create the auth config in Composio
16
17 1. In the Composio dashboard, go to **Auth Configs**, click **Create Auth Config**, and select **Linear**.
18 2. Set the authentication type to **OAuth2** and choose **Use your own developer authentication**.
19 3. Paste the **Client ID** and **Client Secret**, adjust the scopes if needed, then click **Create Linear Auth Config**.
20 4. Click **Connect Account**, click **Authorize** on Linear's consent screen, and confirm the account shows as **Active**.
21
22 See [Custom auth configs](/docs/auth-configuration/custom-auth-configs) for the general flow.
23
24 ### Scopes
25
26 The default auth config requests `read`, `write`, `issues:create`, and `comments:create`. Remove any you don't need from the auth config's **Scopes** field. Linear also offers an `admin` scope; add it only if your integration needs admin access.
27
28 ## Can I connect Linear with an API key?
29
30 Yes. Create an auth config with the **API Key** auth type. Each user creates a personal API key in Linear under **Settings** > **Security & access** > **Personal API keys** and pastes it when connecting. Keys start with `lin_api_`.