title
Create an OAuth Application
description
Register your Plane OAuth application to get Client ID and Secret. Configure setup URL, redirect URI, and webhook endpoints for your integration.
keywords
plane oauth application, create plane app, client id secret, plane app registration, oauth credentials, plane workspace integration, plane api authentication
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.
:::