Create an OAuth Application
- Navigate to Workspace Settings → Integrations.
https://app.plane.so/<workspace>/settings/integrations/ - Click Build your own.
- Fill in the required details:
| Field | Description |
|---|---|
| App Name | Display name shown to users |
| Setup URL | Entry point when users install your app. Your app redirects users to Plane's consent screen from here. |
| Redirect URI | Callback URL where Plane sends users after they approve access, along with the authorization code. |
| Webhook URL | Endpoint for receiving event notifications |
- For agents that respond to @mentions, enable "Enable App Mentions".
- Save and store your Client ID and Client Secret securely.
- Select the scopes you need for your app from the Scopes & Permissions section. See OAuth Scopes for more information on the available scopes.
WARNING
Never expose your Client Secret in client-side code or commit it to version control.