Skip to main content
This guide walks you through connecting your Confluence instance so we can sync the content you choose. It covers three steps:
  1. Authentication — how we securely connect (OAuth 2.0).
  2. Scoping access — how to share only the spaces you want.
  3. Connecting in Pavo — completing the setup.

1. Authentication: OAuth 2.0

We connect to Confluence Cloud using OAuth 2.0 (3LO). You authorize the connection once through Atlassian’s standard consent screen — no passwords or long-lived secrets are shared with us. What to expect:
  • You’ll be redirected to Atlassian to approve the connection.
  • We request read-only scopes (e.g. reading pages and spaces) plus offline_access.
  • After approval, the connection stays active and renews automatically — you won’t need to re-approve on a recurring basis.
Re-approval is only ever needed if:
  • You or an admin revokes our app’s access in Atlassian.
  • The connection sits completely unused for 90+ days.
  • An account security event (e.g. password reset) invalidates the session.

2. Limiting access to select documents

OAuth permissions follow the authorizing user’s access — the connection can see exactly what that account can see. To share only specific content, we recommend a dedicated service account.
  1. Create a new Confluence user (e.g. integration@yourcompany.com).
  2. Grant it access to only the spaces you want to share.
The connection then physically cannot access anything outside what this account is permitted to see — enforced by Confluence, and fully controlled by you from your admin panel. You can broaden or revoke access at any time by adjusting that account’s permissions.

3. Connecting in Pavo

  1. Make sure you have access to Pavo (https://<your_company>.pavoai.dev).
  2. Go to https://<your_company>.pavoai.dev/settings/workspace-connectors.
  3. Scroll to Browse Connectors → Confluence and click Confluence.
  4. Enter your Confluence site URL, e.g. yourcompany.atlassian.net.
  5. Click Connect while signed in as the service account created in Step 2.
Once connected, the docs this account can access are synced automatically and can be used by anyone with access to https://<your_company>.pavoai.dev.