Skip to main content
The Confluence feed connects an index to Atlassian Confluence Cloud through OAuth 2.0 (3LO). After connecting, Circuit imports the pages in the spaces you select and keeps them in sync as they change.

​
What you can do

  • Sync entire spaces: Bring pages and their attachments from any Confluence space you select.
  • Cover multiple spaces in one feed: Pick as many spaces as you like during setup. Adding a space later is also supported.
  • Respect Confluence permissions: Circuit only imports pages your Confluence user can read. Restricted pages stay restricted.
  • Stay in sync automatically: Circuit re-checks each selected space periodically. New pages, edits, and deletions are mirrored to the index.

​
Before you start

  • An Atlassian account with access to the Confluence Cloud site and the spaces you want to sync.
  • The cooperation of an Atlassian organization or site admin. Atlassian sites typically require an org admin to authorize third-party apps before users can connect. See For IT and security teams below.
  • An index in Circuit where the Confluence pages should live. See Indexes if you need to create one.

​
Connect Confluence

1

Open the index's Integrations tab

In Circuit, open the index that should receive the Confluence pages, then choose Integrations > New integration.
2

Choose Import from Confluence

Select Import from Confluence. Circuit redirects you to Atlassian’s sign-in page.
3

Sign in to Atlassian

Sign in with the Atlassian account that has access to the spaces you want to sync.
4

Pick the Confluence site

If your account has access to more than one Atlassian site (sometimes called a cloud ID), Atlassian asks which site to authorize. Choose the site that hosts the spaces you want.
5

Review and consent to the requested scopes

Atlassian shows a consent screen listing the scopes Circuit requests. Review them (see What Circuit accesses below) and click Accept. If your organization blocks third-party apps, the screen is blocked until an org admin approves Circuit.
6

Choose the spaces to sync

After consent, Circuit lists the spaces your account can see. Select the spaces you want imported into the index. Pages outside the selected spaces are never accessed.
7

Start the import

Click Done. Circuit imports the selected spaces. The initial import takes a few minutes to a few hours depending on volume. Subsequent updates run in the background.

​
What Circuit accesses

Circuit requests the following Confluence OAuth scopes: 
read:confluence-content.all
read:confluence-space.summary
read:confluence-user
offline_access
ScopeWhy Circuit needs it
read:confluence-content.allRead the body of pages, blog posts, and comments in the spaces you select, so Circuit can import them.
read:confluence-space.summaryList the spaces your account can see, so you can pick which ones feed into the index.
read:confluence-userResolve page authors and the last editor for each page, so the index can show author metadata in search results.
offline_accessIssue a refresh token so Circuit can keep the feed in sync without asking you to reauthenticate.
Circuit’s access to a space is bounded by your Confluence user’s permissions. If your user cannot view a page in Confluence, Circuit cannot import it either.

​
For IT and security teams

The Confluence feed uses Atlassian’s three-legged OAuth flow (3LO). Each user authorizes the app individually, but Atlassian organization admins can block third-party apps for the whole organization, which prevents any user from completing the flow. If your Atlassian organization has Block user apps enabled, users hitting Circuit’s connect flow will see a “your site admin must authorize this app” error. An org or site admin can approve Circuit from Atlassian Administration > Apps > Connected apps. For the full Atlassian walkthrough, see Approving Circuit in Atlassian. For broader cross-integration security details, see Integration security and admin consent.

​
Disconnect or rotate access

  • From Circuit: open the index’s Integrations tab, select the Confluence feed, and click Remove. Circuit deletes the stored refresh token and stops syncing. Already-imported documents stay in the index until you delete them.
  • From Atlassian: at id.atlassian.com, open Connected apps, find Circuit, and click Revoke. Circuit will lose access on the next sync attempt.
  • Org-wide revocation: an Atlassian org admin can remove Circuit from Connected apps in Atlassian Administration, which invalidates all tokens for the organization.

​
Troubleshooting

The picker only shows spaces your Atlassian account can view. Ask a space admin to add you as a member, or pick a different account when reconnecting.
Page restrictions in Confluence still apply. If your user does not have view permission on a specific page, Circuit cannot read it. Ask the page owner to grant access and the page will appear on the next sync cycle.
The refresh token is invalidated. Open the feed in Circuit and click Reconnect.
Updates are picked up on the next sync cycle, usually within a few hours. If a page remains out of date for longer, force a re-sync from the feed’s settings.

​
Reference