Skip to main content
This guide shows how to connect Confluence Cloud to Clarion using an Atlassian service account and OAuth 2.0 client credentials.
Estimated time: 10-15 minutes. You need access to:
  • A Clarion workspace
  • Atlassian Administration for your Confluence site
  • A service account that can view and search content in the Confluence spaces you want Clarion to use

​
Prerequisites

Before connecting Confluence in Clarion, make sure you have:
  • Your Confluence site URL, for example https://example.atlassian.net
  • A Confluence service account with access to the relevant spaces
  • An OAuth 2.0 credential created for that service account
  • These credential scopes (granular — Clarion uses the Confluence REST API v2):
    • read:page:confluence
    • read:space:confluence
    • search:confluence
Clarion uses the service account’s client credentials to request short-lived Confluence access tokens automatically. You do not need to reconnect the integration just because an access token expires.

​
Step 1 - Create a Confluence service account

  1. In Atlassian Administration, open Directory and create a service account.
  2. Grant the service account access to Confluence.
  3. Make sure the service account has access to the spaces Clarion will read.
The service account should be able to:
  • Search content
  • View page content
  • List spaces

​
Step 2 - Create OAuth 2.0 credentials for the service account

  1. Open the service account in Atlassian Administration.
  2. Go to Credentials.
  3. Create an OAuth 2.0 credential.
  4. Grant only these scopes:
    • read:page:confluence
    • read:space:confluence
    • search:confluence
  5. Copy the Client ID and Client secret.
Keep the client secret somewhere safe. You will paste it into Clarion during setup.

​
Step 3 - Connect Confluence in Clarion

  1. In Clarion, go to Integrations.
  2. Open Confluence.
  3. Enter:
    • Site URL
    • Client ID
    • Client Secret
    • Default Space Key (optional)
  4. Click Connect Confluence.

​
Step 4 - Verify and maintain the connection

After connecting:
  1. Review the saved Confluence site and client ID.
  2. Set or update Default Space Key if you want Clarion to scope searches to a space automatically.
  3. Click Save after any changes.
  4. Click Verify Connection to confirm Clarion can access Confluence successfully.
  5. Use Disconnect if you want to remove Confluence access from the workspace.
Agents can still pass a space in CQL per tool call. If omitted, Clarion uses the configured default space key when scoping a search.

​
How Confluence tools use this integration

When Confluence tools are enabled, Clarion can:
  • Search pages with CQL
  • Read a page by id
  • List spaces
Clarion manages Confluence access tokens automatically from the stored client credentials.

​
Troubleshooting

​
”Failed to resolve Confluence cloud ID”

Check that Site URL is exactly your Confluence Cloud URL, for example:
  • https://example.atlassian.net
Do not include a path such as /wiki, /spaces, or /display.

​
”Confluence credential is missing required scopes”

Recreate or update the OAuth 2.0 credential so it includes:
  • read:confluence-content.all
  • read:confluence-space.summary
  • search:confluence

​
Verify Connection fails even though the credential is valid

Make sure the service account itself has Confluence product access and space-level permissions in the spaces Clarion needs to read.