Skip to main content

Confluence Integration - Setup Guide

Connect your Confluence account to Goodweek to read, create, and update pages, spaces, and blog posts directly from your AI workspace.

A
Written by Antoine Stempien

Connect your Confluence account to Goodweek to read, create, and update pages, spaces, and blog posts directly from your AI workspace.

ℹ️ Governance note

Goodweek will never exceed the access levels granted to the user within Confluence, guaranteeing alignment with your organization's governance policies. Outcomes and available features may vary depending on each user's specific permissions and authenticated access.

📋 Prerequisites

Before any user can see and connect the Confluence integration, your organization admin must first enable it from the Goodweek Admin Panel under the Integrations tab.

Admin Setup

The Confluence integration (app name: Composio- Confluence Connector) uses OAuth 2.0 via Atlassian and does not require any org-level admin approval before users can connect. However, the connecting user must have at least View permissions on the Confluence spaces they want to access.

⚠️ Confluence Cloud only

This integration supports Confluence Cloud only. Confluence Data Center installations are not compatible with this integration.

⚠️ Atlassian security toggle

Some Atlassian organizations have "Third-party app access via OAuth" disabled at the organization level. If users see an "OAuth app access restricted" error when connecting, an Atlassian Organization Admin must enable third-party app access from admin.atlassian.com → Security → Third-party app access.

User Connection

  1. In Goodweek, go to Integrations.

  2. Find Confluence and click Connect.

  3. You will be redirected to Atlassian, where you will be asked to sign in and authorize access.

  4. Select the Confluence site you want to connect and click Accept to return to Goodweek.

Important Notes

  • Each user must connect their own account individually.

  • Goodweek can only access the Confluence spaces, pages, and content that your individual user account has permission to see.

  • This integration supports Confluence Cloud only. Data Center is not supported.

  • You can revoke Goodweek's access at any time from id.atlassian.com → Security → Connected apps → Composio.


Available Tools

Tool

Description

Type

Get Page by ID

Retrieves a Confluence page by its ID, including metadata and content.

Read

Get Pages

Retrieves a paginated list of Confluence pages visible to the authenticated user.

Read

Get Child Pages

Lists all direct child pages of a given Confluence page.

Read

Get Page Ancestors

Retrieves all ancestor pages in the hierarchy for a given Confluence page.

Read

Search Pages

Searches for Confluence pages using filters such as title, space, and status.

Read

Search Content

Searches Confluence content using intelligent title ranking across pages and blog posts.

Read

CQL Search

Searches Confluence using the full Confluence Query Language (CQL) for advanced queries.

Read

Create Page

Creates a new Confluence page in a specified space.

Write

Update Page

Updates an existing Confluence page, replacing its entire content.

Write

Get Page Versions

Retrieves all versions of a specific Confluence page for auditing edit history.

Read

Get Page Labels

Retrieves all labels applied to a specific Confluence page.

Read

Add Content Label

Adds one or more labels to a Confluence page or blog post.

Write

Get Page Footer Comments

Retrieves footer comments on a Confluence page.

Read

Get Page Inline Comments

Retrieves inline comments on a Confluence page.

Read

Create Footer Comment

Creates a footer comment on a Confluence page, blog post, or attachment.

Write

Create Inline Comment

Creates an inline comment highlighting specific text on a Confluence page or blog post.

Write

Get Page Attachments

Retrieves all attachments on a Confluence page.

Read

Download Attachment

Downloads an attachment from a Confluence page and returns a downloadable file.

Read

Get Blogpost by ID

Retrieves a specific Confluence blog post by its ID.

Read

Get Blog Posts

Retrieves a paginated list of Confluence blog posts.

Read

Create Blogpost

Creates a new Confluence blog post in a specified space.

Write

Update Blogpost

Updates an existing Confluence blog post's title or content.

Write

Get Spaces

Retrieves a paginated list of Confluence spaces with optional filtering.

Read

Get Space by ID

Retrieves detailed metadata for a specific Confluence space.

Read

Get Space Contents

Retrieves pages or blog posts within a specific Confluence space.

Read

Search Spaces

Searches for Confluence spaces by name, key, type, status, and labels.

Read

Create Space

Creates a new Confluence space for a knowledge area or team.

Write

Create Whiteboard

Creates a new Confluence whiteboard for collaborative sessions.

Write

Get Tasks

Lists Confluence tasks (action items) with filtering by assignee, creator, space, or status.

Read

Update Task

Updates the status of a Confluence task (e.g., mark as complete or incomplete).

Write

Search Users

Searches for Confluence users using CQL-based user queries.

Read

Get Current User

Retrieves information about the currently authenticated Confluence user.

Read

Delete Page

Permanently deletes a Confluence page and its content. This action cannot be undone.

⚠️ Destructive

Delete Blog Post

Permanently deletes a Confluence blog post. This action cannot be undone.

⚠️ Destructive

Delete Space

Permanently deletes a Confluence space. This is an asynchronous operation and cannot be undone.

⚠️ Destructive

Use Cases

  • Find and read documentation on demand. Search across your Confluence spaces, retrieve specific pages, and bring their content into a Goodweek conversation to reference or build on without navigating Confluence manually.

  • Create and update pages directly. Draft new Confluence pages or update existing documentation from Goodweek — useful for capturing decisions, meeting notes, or project summaries without switching to Confluence.

  • Add comments and feedback to pages. Leave inline or footer comments on specific Confluence pages directly from a Goodweek conversation to share feedback or flag items for review.

  • Manage tasks and action items. List and update Confluence tasks filtered by assignee or space to track outstanding action items across your knowledge base.


Troubleshooting

"OAuth app access restricted" when connecting

Your Atlassian organization has restricted third-party app access. An Atlassian Organization Admin must enable it from admin.atlassian.com → Security → Third-party app access.

Connected successfully but some spaces or pages are missing

Goodweek can only access spaces and pages your user account has permission to see. Ask your Confluence admin to verify your space permissions.

Integration not visible in Goodweek

Make sure your organization admin has enabled the Confluence integration from the Goodweek Admin Panel under the Integrations tab.

References

Did this answer your question?