Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Mirrored from https://github.com/Camo67/composio.git
Synced Nov 21, 04:45 UTC
How do I set up custom OAuth credentials for Confluence?
Use your own Atlassian OAuth 2.0 (3LO) app when you want the consent screen to show your app name and to control which scopes it can grant.
Create the Atlassian app
- Sign in to the Atlassian developer console (create a developer account if you don't have one).
- Click Create → OAuth 2.0 integration, name the app, and click Create.

- Open Authorization in the sidebar and click Configure next to OAuth 2.0 (3LO). Set Callback URL to
https://backend.composio.dev/api/v1/auth-apps/addand click Save changes. It must exactly match the auth config'soauth_redirect_urifield.

- Open Permissions. Click Add next to the Confluence API, then Configure, and add every classic or granular scope your auth config will request (see below). Add the User Identity API too if you need user profile scopes. Click Save.


- Open Distribution and set the status to Sharing if users outside your own Atlassian account will connect. Atlassian asks for a vendor name, privacy policy URL, and a personal data declaration.
- Open Settings and copy the Client ID and Secret under Authentication details.
Create the auth config in Composio
- In the Composio dashboard, go to Auth Configs → Create and select Confluence.
Choose OAuth 2.0 and Your Own Credentials, then paste the Client ID and Secret.
Remove any scopes you didn't add on the app's Permissions tab, then click Create Auth Config.
Click Connect Account and enter your site's subdomain: the part before
.atlassian.netin your browser's address bar. Forhttps://acme.atlassian.net, enteracme.Approve the consent screen and check that the account shows Active.
See custom auth configs for the general flow.
Scopes
The default auth config requests granular Confluence scopes for pages, blog posts, content, comments, whiteboards, inline tasks, tasks, content restrictions and metadata, space details, and the audit log (for example read:page:confluence, write:page:confluence, read:comment:confluence, read:space-details:confluence), plus offline_access. The full list is in the auth config's scope picker. See Atlassian's Confluence scopes reference.
Every scope the auth config requests, apart from offline_access, must also be added on the app's Permissions tab. If one is missing, the connection fails with a "Something went wrong" error. Keep offline_access in the auth config's scopes: Atlassian only issues a refresh token when it's requested, and without one the connection stops working when the access token expires.
