Skip to main content

Connecting Confluence to Axiamatic

Connect your Confluence workspace to unlock AI-powered insights from your organization's documentation, meeting notes, and project pages.

A
Written by Axiamatic

Connecting Confluence to Axiamatic transforms your workspace into an intelligent knowledge source. Once connected, Axiamatic can understand and reference your organization's documentation, providing contextually relevant answers based on your team's actual content.

Prerequisites: Create a Personal Access Token (PAT)

Before connecting Confluence to Axiamatic, you will need to generate a Personal Access Token from your Atlassian account.

Steps to create a PAT:

Step 1: Access Your Atlassian Profile

In Confluence, select your profile picture in the top-right corner of the screen and choose Settings from the dropdown menu.

Step 2: Navigate to Security Settings

Under your account settings, select Security from the top menu. Click Create and manage API tokens under the API token section.

Step 3: Create a New Token

Atlassian offers two types of API tokens. We recommend using a scoped token as it follows Atlassian's latest security model and limits access to only what Axiamatic needs:

  1. Scoped API Token (Recommended): Click Create API token with scopes and enable the following permissions:

    • read:content:confluence

    • read:content-details:confluence

    • read:hierarchical-content:confluence

    • read:attachment:confluence

    • read:space:confluence

    • read:user:confluence

    • search:confluence

  2. Classic API Token (Alternative): Click Create API token if you prefer a token with full access and no scope restrictions.

Give your token a meaningful name such as "Confluence Axiamatic Integration".

Step 4: Set an Expiry Date

Choose an expiry date for your token. If your workspace administrator permits it, you can select No expiry.

Step 5: Copy and Store Your Token

Click Create API token. Copy this token immediately and store it securely. It will only be displayed once and cannot be retrieved again after you leave this screen.

Step 6: Find Your Cloud ID (Scoped Token Only)

If you are using a scoped API token, you will also need your Atlassian Cloud ID. To find it, open the Confluence tab in your browser and modify the URL in the address bar to the following, then press 'Enter'.
​

https://<your-site>.atlassian.net/_edge/tenant_info

Replace <your-site> with your organisation's Atlassian domain. The page will return a JSON object. Copy the value of the cloudId field.

Step 1: Open Settings and Integrations

  1. Log in to your Axiamatic account and click your profile icon in the bottom-left corner of the page.

  2. From the menu, select Program Settings, then open the Integrations section.

Step 2: Connect to Confluence

  1. On the Integrations page, locate the File Sync section.

  2. Find the Confluence integration card and click Connect.
    ​

  3. When prompted, select how you want to scope this connection.

    1. Shared Connection: Makes this Confluence connection available to all current and future projects or business units using Axiamatic in your workspace. This is the recommended option for most teams.

    2. Private Connection: Limits this Confluence connection to the current project or account only. Future projects will need their own separate connection.

Choose the option that best fits how your organization manages projects and data.

Step 3: Enter Your Confluence Details

A pop-up will appear asking you to link your Confluence account. Select the authentication option that matches the token type you created in the Prerequisites section:

  • Default Authentication: Use this if you created a classic API token.

  • API Token (Scoped): Use this if you created a scoped API token with the recommended permissions.

Selecting either option will expand the form with the relevant credential fields to fill in.
​

  • Cloud ID as per Atlassian cloud prefix: Your organisation's Atlassian subdomain (e.g., if your Confluence URL is https://yourcompany.atlassian.net, enter yourcompany).

  • Email: The email address associated with your Atlassian account.

  • Scoped API Token: The API token you generated in the Prerequisites section.

  • Atlassian Cloud ID: The Cloud ID you copied in Step 6 of the Prerequisites.

Once all fields are filled in, click Connect.


​Integration complete!

The Confluence card will now show a Connected status, confirming the integration is active. To disconnect at any time, click the "Disconnect" button on the card.

Step 4: Navigate to Channels

In the left navigation, click on the Channels tab, located just below the Integrations tab.

Step 5: Configure Confluence

In the Channels view, find the Confluence tile and click Configure (or Add Filter). A configuration dialog will open.
​

Step 6: Enter a CQL Query

In the dialog, you will see an input field to define your CQL query. This controls which Confluence content Axiamatic accesses and analyzes. Enter your desired query and click Save.
​

What is CQL?

CQL (Confluence Query Language) is a structured query language used to search and filter content in Confluence. It lets you specify precisely what data Axiamatic should access — such as pages from a specific space, recently created content, or pages with certain labels. For detailed documentation, refer to the Confluence CQL Advanced Searching Guide.

Example CQL query — to sync all pages within a specific space:

space = "ENG" AND type = "page"

These filters ensure only relevant content is indexed and used by Axiamatic.

Configuration complete! The configured query will be displayed on the Confluence tile, confirming the setup is complete. Axiamatic will now use this query to retrieve and analyze your Confluence data.

How Axiamatic Uses Your Confluence Data

What Axiamatic accesses:

Spaces and Page Data

  • Reads information about spaces (names, keys, descriptions)

  • Reads page details including titles, body content, metadata, and hierarchy

  • Searches for pages, blogs, and other content based on the configuration

Attachments and Files

  • Reads attachments linked to pages or blogs (documents.)

  • Accesses attachment metadata (filename, type, uploader, date)

User Information

  • Reads user profile information visible to your account

  • Views usernames, email addresses, and profile avatars associated with content creators or editors

Important Notes

  • Access is read-only: the integration does not create, update, or delete any Confluence content.

  • Data access is always limited to what your Confluence account already has permission to view.

  • Accesses user profiles visible to your account

  • Views usernames, email addresses, and profile avatars

  • Limited to information you already have permission to see in Confluence

For pricing information, demo requests, or assistance, contact us at [email protected]

Did this answer your question?