Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
| 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 |  |
| 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_`. |