Skip to content

Connect Confluence

Solutioneer uses the Composio confluence toolkit for Confluence writeback. Multiple skills can write to Confluence.

  • A Composio API key in .env.
  • A Confluence account with permission to create pages in the target space.

The confluence toolkit exposes these tool slugs to Solutioneer:

  • CONFLUENCE_CREATE_PAGE — create a page in a target space.
  • CONFLUENCE_UPDATE_PAGE — update an existing page by id.

The normal flow runs inside Codex:

  1. Ask for an external write. For example: “Push this POC plan to a Confluence page in the SE space.”
  2. Codex verifies that COMPOSIO_API_KEY is present.
  3. Codex checks whether the confluence toolkit is connected.
  4. If it is not, Codex offers Connect now / Skip.
  5. Connect now opens the Composio hosted login page in a browser tab.
  6. You complete the Confluence OAuth flow — this typically includes picking the Atlassian site and the workspace to connect.
  7. Codex polls the connected account until it becomes ACTIVE.
  8. Once active, Codex executes the write.

If browser tooling is unavailable, Codex provides the login link in chat and waits for you to finish the flow.

  1. Open the Composio dashboard.
  2. Go to Connections.
  3. Find the confluence toolkit.
  4. Click Connect and pick the Atlassian site to grant access to.
  5. Confirm the connection shows as Active.
  • Account Intel Brief — pushes the brief as a new Confluence page.
  • Integration Fit Gap Analyzer — pushes the fit-gap report as a new Confluence page.
  • POC Handoff Orchestrator — pushes the POC plan and architecture note as new Confluence pages and can update existing pages.

Codex confirms before writing. The target space is part of the destination confirmation — Solutioneer does not guess the space. If you did not ask for a Confluence write, it will not push to Confluence.

  • No spaces listed. Your Composio connection may be scoped to a Confluence site with no spaces visible to the account you authed with. Re-connect with an account that has space-level access.
  • Parent page not found. If you asked Codex to create a page under a parent, make sure the parent page id is correct. Codex will not invent a parent id.

See Troubleshooting for more.