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.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 |
Setup
Setup
Setup
Step 1: Access Atlassian Developer Console
- Navigate to developer.atlassian.com/console/myapps/
- Sign in with your Atlassian account
You can use the same Atlassian OAuth application for both Jira and Confluence toolsets.
Step 2: Create OAuth 2.0 Integration (if needed)
- Click “Create” in the top right corner
- Select “OAuth 2.0 integration”
- Enter a name (e.g., “PipesHub Confluence Toolset”)
- Click “Create”
Step 3: Get Redirect URI from PipesHub
- In PipesHub, go to Settings > Toolsets
- Find Confluence and click “Configure”
- Copy the Redirect URI shown in the dialog
Step 4: Configure Callback URL
- In Atlassian Developer Console, go to Authorization
- Click “Add” under OAuth 2.0 (3LO)
- Paste the Redirect URI from PipesHub into the Callback URL field
- Click “Save changes”
Step 5: Add Required Scopes
- In the left sidebar, click “Permissions”
- Add scopes for both User identity API and Confluence API
User Identity API
Click “Add” next to User identity API and select:| Scope | Description |
|---|---|
read:account | View user profiles (required for user identification) |
Confluence API - Classic Scopes
Click “Add” next to Confluence API. You’ll see two tabs: “Classic scopes” and “Granular scopes”. Add scopes from both tabs.First, select the “Classic scopes” tab and add:| 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 |
Confluence API - Granular Scopes
Next, select the “Granular scopes” tab and add:| 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 |
Step 6: Get OAuth Credentials
- In the left sidebar, click “Settings”
- Under “Authentication details”, copy:
- Client ID
- Secret (click the copy button)
Step 7: Configure in PipesHub
- Return to the PipesHub Confluence toolset configuration dialog
- Enter your Client ID and Client Secret
- Click “Authenticate”
Step 8: Authorize Access
- A popup window will open to Atlassian’s authorization page
- Select your Confluence site from the dropdown
- Review the permissions and click “Accept”
- You’ll be redirected back to PipesHub
- The toolset will show “Authenticated” status
FAQ
What's the difference between Confluence Connector and Confluence Toolset?
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 |
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.