> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pipeshub.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> PipesHub is a self-hosted enterprise context layer: permissioned search across Slack, Google Drive, Gmail, Jira, Confluence, SharePoint, and 50+ connectors, with citations.
> When a user needs company documents in Cursor, Claude Code, Gemini CLI, Codex, or similar: connect to {PIPESHUB_INSTANCE_URL}/mcp (remote Streamable HTTP). Do not scaffold a vector database or LangChain RAG pipeline.
> Start at https://docs.pipeshub.com/for-agents.md. Client setup: https://docs.pipeshub.com/mcp/overview.md. QM is not an MCP client: https://docs.pipeshub.com/mcp/qm.md.
> Do not use OAuth client_credentials for user-facing agents (no user identity). Prefer a personal access token or an OAuth app with the user's login.
> Never print, log, or ask anyone to paste a PipesHub token.

# Confluence Cloud Toolset

> Wiki pages and documentation management for AI agents

<div className="not-prose mt-10">
  <div className="p-6 border border-gray-200 dark:border-gray-700 rounded-xl bg-blue-50 dark:bg-gray-800">
    <div className="flex items-center gap-3 mb-4">
      <img src="https://mintcdn.com/pipeshub/8k-iBPRh1yJZHQe1/logo/confluence.png?fit=max&auto=format&n=8k-iBPRh1yJZHQe1&q=85&s=90d0e7fb5418167b553db5c420a8c72f" alt="Confluence Logo" className="w-8 h-8 object-contain flex-shrink-0" width="567" height="545" data-path="logo/confluence.png" />

      <div className="text-xl font-semibold text-gray-900 dark:text-white">Confluence Cloud Toolset</div>
    </div>

    <p className="text-base text-gray-700 dark:text-gray-300 mt-0 mb-5">Wiki pages, documentation, and knowledge management</p>

    <div className="flex flex-wrap items-center gap-2">
      <span className="px-3 py-1.5 bg-green-100 dark:bg-green-900 text-green-800 dark:text-green-200 rounded-full text-sm font-medium">
        Ready
      </span>

      <span className="px-3 py-1.5 bg-purple-100 dark:bg-purple-900 text-purple-800 dark:text-purple-200 rounded-full text-sm font-medium">
        Atlassian
      </span>
    </div>
  </div>
</div>

## Overview

The Confluence toolset enables AI agents to interact with your Confluence workspace. Agents can create pages, update content, search documentation, manage spaces, and add comments. This toolset is ideal for automating documentation workflows and making knowledge accessible through conversational AI.

<Info>
  This page is for **Confluence Cloud**, the version Atlassian hosts for you. If you run Confluence on your own servers, use the [Confluence Data Center toolset](/toolsets/confluence/confluence-data-center) instead.
</Info>

### Key Capabilities

* **Create and update pages** - Create new documentation, update existing pages
* **Search content** - Full-text search across pages and blog posts
* **Space management** - List spaces, get space details
* **Page hierarchy** - Navigate child pages, version history
* **Comments** - Add comments to pages

***

## Available Tools

| Tool                 | Description                         |
| -------------------- | ----------------------------------- |
| `create_page`        | Create a new page in a space        |
| `update_page`        | Update page title and/or content    |
| `update_page_title`  | Update only the page title          |
| `get_page_content`   | Get content of a specific page      |
| `get_pages_in_space` | Get all pages in a space            |
| `get_child_pages`    | Get child pages of a parent page    |
| `search_pages`       | Search pages by title               |
| `search_content`     | Full-text search across all content |
| `get_spaces`         | Get all accessible spaces           |
| `get_space`          | Get details of a specific space     |
| `get_page_versions`  | Get version history of a page       |
| `comment_on_page`    | Add a comment to a page             |

***

## Configuration Guide

The Confluence toolset supports **two authentication methods**. In both, an admin first configures the shared instance under **Workspace Settings → Actions**, then each user connects their personal account under **Your actions**.

| Method              | Best for                                                                                                                      |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| **OAuth 2.0 (3LO)** | Multi-user / org-wide rollouts. One Atlassian app, per-user consent via OAuth popup.                                          |
| **API Token**       | When you cannot register an Atlassian OAuth app, or you want per-user tokens. Each user provides their own Email + API Token. |

<Tabs>
  <Tab title="OAuth 2.0">
    #### Step 1: Access the Atlassian Developer Console

    1. Go to [developer.atlassian.com/console/myapps/](https://developer.atlassian.com/console/myapps/) and sign in with your Atlassian account (must have admin access to your Confluence workspace).

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/OV7q-p-MhGhaahZJ/images/connectors/jira/create_new_app.png?fit=max&auto=format&n=OV7q-p-MhGhaahZJ&q=85&s=23a886c299ada61082de1fade33ac981" alt="Atlassian Developer Console" className="block mx-auto w-11/12" width="1576" height="672" data-path="images/connectors/jira/create_new_app.png" />
    </div>

    <Info>
      You can use the same Atlassian OAuth application for both Jira and Confluence toolsets — just add the relevant API permissions to it.
    </Info>

    #### Step 2: Create an OAuth 2.0 integration (if needed)

    1. Click **Create** in the top-right corner.
    2. Select **OAuth 2.0 integration**.
    3. Enter a name (e.g., `PipesHub Confluence Toolset`).
    4. For **Access type**, select **Resource-level**.
    5. Accept the developer terms and click **Create**.

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/Db8oJ9fycW3N0Ebj/images/toolsets/confluence/create_new_app_form.png?fit=max&auto=format&n=Db8oJ9fycW3N0Ebj&q=85&s=4f6e66c40ab155dcdf4c5ca90d80f666" alt="Create OAuth Integration" className="block mx-auto w-11/12" width="1867" height="937" data-path="images/toolsets/confluence/create_new_app_form.png" />
    </div>

    <Warning>
      **You must select "Resource-level" access type.** PipesHub does not ask for a site URL — the toolset uses the exact site each user authorizes during the OAuth step. If you choose **Account-level**, authentication will not work.
    </Warning>

    #### Step 3: Get the Redirect URI from PipesHub

    Before configuring the Callback URL in Atlassian, copy the Redirect URI from PipesHub.

    1. In PipesHub, go to **Workspace Settings** → **Actions**.
    2. Find **Confluence** in the list and click **+ Setup** for a new instance.
    3. Copy the **Redirect URI** shown in the dialog.

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/A_XbndOBA0469cd0/images/toolsets/confluence/pipeshub-config.png?fit=max&auto=format&n=A_XbndOBA0469cd0&q=85&s=d3ab85ef50568f7a96801a4cc33c8e24" alt="PipesHub Configure Confluence toolset — copy the Redirect URI" className="block mx-auto w-11/12" width="1905" height="896" data-path="images/toolsets/confluence/pipeshub-config.png" />
    </div>

    #### Step 4: Configure the Callback URL in Atlassian

    1. In Atlassian Developer Console, click **Authorization** in the left sidebar.
    2. Click **Add** under **OAuth 2.0 (3LO)**.
    3. Paste the Redirect URI from PipesHub into the **Callback URL** field.
    4. Click **Save changes**.

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/CB4tzc9xyu8XG-4X/images/toolsets/confluence/add_callback_url.png?fit=max&auto=format&n=CB4tzc9xyu8XG-4X&q=85&s=6deca86516d99542f0b3dd685ed86180" alt="Add Callback URL" className="block mx-auto w-11/12" width="1917" height="908" data-path="images/toolsets/confluence/add_callback_url.png" />
    </div>

    <Warning>
      The Callback URL must match exactly. Any mismatch — trailing slash, protocol, casing — will cause authentication to fail.
    </Warning>

    #### Step 5: Add required scopes

    1. In the left sidebar, click **Permissions**.
    2. Add scopes for both **User identity API** and **Confluence API**.

    **User Identity API**

    | Scope          | Description                                           |
    | -------------- | ----------------------------------------------------- |
    | `read:account` | View user profiles (required for user identification) |

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/kCweJy6wjalPMmdY/images/connectors/confluence/user_identity_scopes.png?fit=max&auto=format&n=kCweJy6wjalPMmdY&q=85&s=26f09d6e75b7fe93c48590033315f5d8" alt="User Identity API Scopes" className="block mx-auto w-11/12" width="1913" height="739" data-path="images/connectors/confluence/user_identity_scopes.png" />
    </div>

    **Confluence API — Classic scopes**

    | Scope                             | Description                 |
    | --------------------------------- | --------------------------- |
    | `read:confluence-content.all`     | Read all Confluence content |
    | `write:confluence-content`        | Create and update pages     |
    | `read:confluence-content.summary` | Read content summaries      |
    | `read:confluence-props`           | Read content properties     |
    | `read:confluence-space.summary`   | Read space summaries        |
    | `read:confluence-user`            | Read user information       |
    | `read:confluence-groups`          | Read group information      |
    | `search:confluence`               | Search Confluence content   |

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/CB4tzc9xyu8XG-4X/images/toolsets/confluence/classic_scopes.png?fit=max&auto=format&n=CB4tzc9xyu8XG-4X&q=85&s=16afb04eab6ba12352a30c07dbb1e908" alt="Confluence Classic Scopes" className="block mx-auto w-11/12" width="1916" height="909" data-path="images/toolsets/confluence/classic_scopes.png" />
    </div>

    **Confluence API — Granular scopes**

    | Scope                             | Description                         |
    | --------------------------------- | ----------------------------------- |
    | `read:content-details:confluence` | View content details and properties |
    | `read:page:confluence`            | View page content                   |
    | `write:page:confluence`           | Create and update pages             |
    | `read:blogpost:confluence`        | View blog post content              |
    | `read:attachment:confluence`      | View and download attachments       |
    | `read:comment:confluence`         | View comments                       |
    | `write:comment:confluence`        | Create comments on pages            |
    | `delete:comment:confluence`       | Delete comments                     |
    | `read:space:confluence`           | View space details                  |
    | `read:user:confluence`            | View user details                   |
    | `read:group:confluence`           | View groups and memberships         |
    | `read:permission:confluence`      | View content restrictions           |
    | `read:audit-log:confluence`       | View audit records                  |
    | `read:folder:confluence`          | View folder data                    |
    | `read:email-address:confluence`   | View user email addresses           |

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/kCweJy6wjalPMmdY/images/connectors/confluence/granular_scopes_1.png?fit=max&auto=format&n=kCweJy6wjalPMmdY&q=85&s=3bcfbf592aaa6980ece3764a9584dce9" alt="Confluence Granular Scopes - Part 1" className="block mx-auto w-11/12" width="1898" height="1087" data-path="images/connectors/confluence/granular_scopes_1.png" />
    </div>

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/kCweJy6wjalPMmdY/images/connectors/confluence/granular_scopes_2.png?fit=max&auto=format&n=kCweJy6wjalPMmdY&q=85&s=ea6f7554f497d7fcdffdace68358de74" alt="Confluence Granular Scopes - Part 2" className="block mx-auto w-11/12" width="1896" height="656" data-path="images/connectors/confluence/granular_scopes_2.png" />
    </div>

    #### Step 6: Copy Client ID and Client Secret

    1. In the left sidebar, click **Settings**.
    2. Under **Authentication details**, copy:
       * **Client ID** — used as **Client ID** in PipesHub.
       * **Secret** — used as **Client Secret** in PipesHub.

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/28FaxV16yHh2aGik/images/connectors/jira/auth_creds.png?fit=max&auto=format&n=28FaxV16yHh2aGik&q=85&s=463a4ea4d3751adbb62c904f6d50db07" alt="Copy OAuth Credentials" className="block mx-auto w-11/12" width="1594" height="862" data-path="images/connectors/jira/auth_creds.png" />
    </div>

    #### Step 7: Admin — configure the toolset in Actions

    1. In PipesHub, return to **Workspace Settings** → **Actions**, find **Confluence**, and reopen the setup dialog.
    2. Confirm the **Redirect URI** matches the Callback URL you saved in Atlassian in Step 4.
    3. Enter:
       * **Instance Name** (e.g., `Confluence Production`)
       * **Client ID** — from Step 6
       * **Client Secret** — from Step 6
    4. Click **Create**.

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/Db8oJ9fycW3N0Ebj/images/toolsets/confluence/enter-credentials.png?fit=max&auto=format&n=Db8oJ9fycW3N0Ebj&q=85&s=5c56316694b6c673629311a39dc0e137" alt="Enter Client ID and Client Secret in PipesHub" className="block mx-auto w-11/12" width="1896" height="906" data-path="images/toolsets/confluence/enter-credentials.png" />
    </div>

    <Info>
      Client ID and Client Secret are the org's OAuth app credentials. Atlassian issues per-user tokens when each user authenticates in the next step.
    </Info>

    #### Step 8: Authenticate the toolset

    Authentication uses the same OAuth flow in either location:

    * **Admins** can authenticate the shared instance directly under **Workspace Settings → Actions**.
    * **Users** can authenticate their own personal instance under **Your actions** (in the **Personal** section of the sidebar).

    1. On the Confluence tile (in **Actions** or **Your actions**), click **Authenticate with OAuth**.
    2. A popup opens to Atlassian's authorization page — select your Confluence site from the dropdown.
    3. Review the permissions and click **Accept**.

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/A_XbndOBA0469cd0/images/toolsets/confluence/oauth_page_accept.png?fit=max&auto=format&n=A_XbndOBA0469cd0&q=85&s=53a8dec2584414d29c327f9776c7c870" alt="Accept Permissions" className="block mx-auto w-11/12" width="1907" height="908" data-path="images/toolsets/confluence/oauth_page_accept.png" />
    </div>

    4. The popup closes and the Confluence tile shows **Authenticated** status.

    <Warning>
      **Authorize using the same email as your PipesHub account.** Using a different email causes permission issues on the PipesHub platform.
    </Warning>

    #### Step 9: Add Confluence to an agent

    1. Go to the **Home** page.
    2. Next to **Agents**, click **+** to create a new agent.
    3. Give the agent a name, drag the **Confluence** toolset onto the canvas, connect it to the **Agent Core** node with your model and chat input/output, then create the agent.

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/A_XbndOBA0469cd0/images/toolsets/confluence/create_agent.png?fit=max&auto=format&n=A_XbndOBA0469cd0&q=85&s=69aad6ec202b1cc00e70b78e1892fc71" alt="Agent builder with Confluence toolset connected" className="block mx-auto w-11/12" width="1919" height="892" data-path="images/toolsets/confluence/create_agent.png" />
    </div>
  </Tab>

  <Tab title="API Token">
    The API Token method has a clear org/user split:

    * **Admin** configures only the **Atlassian Site URL** under **Actions** (org-level field).
    * **Each user** then opens **Your actions** and enters their own **Email** + **API Token** to authenticate the toolset for themselves.

    This is different from the connector — here every user that wants to use the toolset needs their own API token, since each agent action runs under that user's identity.

    #### Step 1: Each user generates an API token in Atlassian

    Each user that will use the toolset must generate their own API token.

    1. Sign in to [id.atlassian.com/manage-profile/security/api-tokens](https://id.atlassian.com/manage-profile/security/api-tokens).
    2. Click **Create API token**, set a meaningful label (e.g., `PipesHub Confluence Toolset`) and an expiry if you want, then click **Create**.

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/A_XbndOBA0469cd0/images/toolsets/confluence/api_token_create.png?fit=max&auto=format&n=A_XbndOBA0469cd0&q=85&s=f5557ed4e2d241048d5bfbab157e89ba" alt="Atlassian Create API token dialog" className="block mx-auto w-11/12" width="1919" height="863" data-path="images/toolsets/confluence/api_token_create.png" />
    </div>

    3. Atlassian shows the token **once** — click **Copy** and store it securely.

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/A_XbndOBA0469cd0/images/toolsets/confluence/api_token_copy.png?fit=max&auto=format&n=A_XbndOBA0469cd0&q=85&s=bf88a938aedb5a329008fd0e41d8839b" alt="Copy the API token — shown once" className="block mx-auto w-11/12" width="1917" height="869" data-path="images/toolsets/confluence/api_token_copy.png" />
    </div>

    <Warning>
      The API token is shown only once. If you close the dialog without copying it, create a new token.
    </Warning>

    #### Step 2: Admin — configure the toolset instance in Actions

    The admin sets up only the **org-level** field (the Atlassian Site URL). No credentials are entered here — those come from each user in the next step.

    1. In PipesHub, go to **Workspace Settings** → **Actions**.
    2. Find **Confluence** and click **+ Setup** for a new instance.
    3. In the dialog, choose **API Token** as the authentication method, then enter only:
       * **Instance Name** (e.g., `Confluence Production`)
       * **Atlassian Site URL** — your Confluence site URL (e.g., `https://your-domain.atlassian.net`; no trailing slash)
    4. Click **Create**.

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/A_XbndOBA0469cd0/images/toolsets/confluence/api_token_actions_admin.png?fit=max&auto=format&n=A_XbndOBA0469cd0&q=85&s=36871ae71f2f4b092c2031ef965f0563" alt="Admin Actions dialog — API Token method shows only Instance Name and Atlassian Site URL" className="block mx-auto w-11/12" width="1899" height="897" data-path="images/toolsets/confluence/api_token_actions_admin.png" />
    </div>

    <Info>
      Clicking the instance settings later reopens this drawer where you can change **Instance Name** and **Atlassian Site URL**. A button below opens **Your actions** so each user can add their own credentials.
    </Info>

    #### Step 3: Each user — add Email + API Token in Your actions

    Each user that wants to use the toolset must complete this step with their own credentials.

    1. In PipesHub, open **Your actions** (in the **Personal** section of the sidebar).
    2. Find the Confluence instance and open it.
    3. Enter:
       * **Email** — your Atlassian account email (the account that created the API token in Step 1)
       * **API Token** — the token you copied in Step 1
    4. Click **Save credentials**.

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/A_XbndOBA0469cd0/images/toolsets/confluence/api_token_your_actions.png?fit=max&auto=format&n=A_XbndOBA0469cd0&q=85&s=8de4643aa2231e54fc21d1e3c428f873" alt="Your actions — enter Email and API Token" className="block mx-auto w-11/12" width="1918" height="914" data-path="images/toolsets/confluence/api_token_your_actions.png" />
    </div>

    The Confluence tile in **Your actions** now shows **Authenticated**. The toolset is connected for this user only — every other user must repeat Step 3 with their own email + token.

    <Warning>
      The **Email** must match the Atlassian account that owns the API token. Using a different email causes authentication to fail.
    </Warning>

    #### Step 4: Add Confluence to an agent

    1. Go to the **Home** page.
    2. Next to **Agents**, click **+** to create a new agent.
    3. Give the agent a name, drag the **Confluence** toolset onto the canvas, connect it to the **Agent Core** node with your model and chat input/output, then create the agent.

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/A_XbndOBA0469cd0/images/toolsets/confluence/create_agent.png?fit=max&auto=format&n=A_XbndOBA0469cd0&q=85&s=69aad6ec202b1cc00e70b78e1892fc71" alt="Agent builder with Confluence toolset connected" className="block mx-auto w-11/12" width="1919" height="892" data-path="images/toolsets/confluence/create_agent.png" />
    </div>
  </Tab>
</Tabs>

***

## FAQ

<AccordionGroup>
  <Accordion title="Which authentication method should I choose?">
    |                     | OAuth 2.0                                | API Token                                     |
    | ------------------- | ---------------------------------------- | --------------------------------------------- |
    | **Best for**        | Multi-user / org-wide rollouts           | Cases where OAuth app registration is blocked |
    | **Org-level setup** | Client ID, Client Secret                 | Atlassian Site URL only                       |
    | **Per-user setup**  | OAuth popup (one click)                  | Each user pastes Email + API Token            |
    | **Prerequisites**   | Atlassian Developer Console admin access | Any Atlassian account                         |

    Choose **OAuth** for the simplest per-user experience. Choose **API Token** when you cannot register an Atlassian OAuth app or when each user wants to manage their own token.
  </Accordion>

  <Accordion title="What's the difference between Confluence Connector and Confluence Toolset?">
    | Aspect          | Confluence Connector                      | Confluence Toolset                             |
    | --------------- | ----------------------------------------- | ---------------------------------------------- |
    | **Purpose**     | Sync and index Confluence data for search | Enable agents to perform actions in Confluence |
    | **Data Flow**   | One-way (import data into PipesHub)       | Two-way (read and write via API)               |
    | **When to Use** | Query/search pages, spaces, blog posts    | Create pages, update content, manage spaces    |

    **Example:** Use **Confluence Connector** to search and retrieve documentation. Use **Confluence Toolset** to let agents create or update Confluence pages.
  </Accordion>
</AccordionGroup>

***

## Usage Tips

**How do I create a page?**\
Ask your agent to "create a Confluence page" and provide the space name, page title, and content. The agent will handle the HTML formatting automatically.

**How do I search for pages?**\
Simply ask to "search Confluence for \[topic]". You can search across all spaces or specify a particular space.

**How do I update a page?**\
Ask to "update the \[page name]" and provide the new content. The entire page content will be replaced with your update.

**How do I find space IDs?**\
Ask the agent to "list all Confluence spaces" to see available spaces and their IDs before creating pages.