Steps
-
Create an Atlassian Developer Account
- Go to the Atlassian Developer Portal
- Sign up or sign in with your Atlassian account
-
Create an OAuth 2.0 Application
- Go to Atlassian Apps Console
- Create a new app of type OAuth 2.0 Integration
- Name your application and click Create
-
Configure the Callback URL
- Go to the Authorization tab in the left sidebar
- Click Configure
- Enter your OAuth callback URL in the input field
-
Configure Scopes (Permissions)
- Go to the Permissions tab in the left sidebar
- Configure scopes under User Identity API and Confluence API
- Select either Classic or Granular scopes based on your needs
- Common scopes include:
read:confluence-content.all— Read all contentwrite:confluence-content— Create/update contentread:confluence-space.summary— Read space summariesread:confluence-user— Read user dataoffline_access— Refresh tokens
- Click Save
-
Copy OAuth Credentials
- Go to the Settings tab
- Under Authentication Details, find the Client ID and Client Secret
- Copy both values
Key Details
- Developer Console: https://developer.atlassian.com/console/myapps
- Auth Type: OAuth 2.0
- Authorization URL:
https://auth.atlassian.com/authorize - Token URL:
https://auth.atlassian.com/oauth/token - Base API URL:
https://api.atlassian.com/ex/confluence/{cloudId} - Credentials Location: App → Settings → Authentication Details
- Common Granular Scopes:
read:page:confluence,write:page:confluence,read:space:confluence,read:content:confluence,write:content:confluence,read:attachment:confluence,read:comment:confluence,write:comment:confluence,offline_access - Note: Your Confluence subdomain is the part before
.atlassian.netin your URL