Skip to main content
Confluence Logo
Confluence Cloud Toolset

Wiki pages, documentation, and knowledge management

ReadyAtlassian

​
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.
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 instead.

​
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

​
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.

​
Step 1: Access the Atlassian Developer Console

  1. Go to developer.atlassian.com/console/myapps/ and sign in with your Atlassian account (must have admin access to your Confluence workspace).
Atlassian Developer Console
You can use the same Atlassian OAuth application for both Jira and Confluence toolsets — just add the relevant API permissions to it.

​
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.
Create OAuth Integration
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.

​
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.
PipesHub Configure Confluence toolset — copy the Redirect URI

​
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.
Add Callback URL
The Callback URL must match exactly. Any mismatch — trailing slash, protocol, casing — will cause authentication to fail.

​
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
User Identity API Scopes
Confluence API — Classic scopes
Confluence Classic Scopes
Confluence API — Granular scopes
Confluence Granular Scopes - Part 1
Confluence Granular Scopes - Part 2

​
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.
Copy OAuth Credentials

​
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.
Enter Client ID and Client Secret in PipesHub
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.

​
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.
Accept Permissions
  1. The popup closes and the Confluence tile shows Authenticated status.
Authorize using the same email as your PipesHub account. Using a different email causes permission issues on the PipesHub platform.

​
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.
Agent builder with Confluence toolset connected

​
FAQ

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.
Example: Use Confluence Connector to search and retrieve documentation. Use Confluence Toolset to let agents create or update Confluence pages.

​
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.