Connect Confluence
Solutioneer uses the Composio confluence toolkit for Confluence writeback.
Multiple skills can
write to Confluence.
Prerequisites
Section titled “Prerequisites”- A Composio API key in
.env. - A Confluence account with permission to create pages in the target space.
What gets connected
Section titled “What gets connected”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.
How to connect
Section titled “How to connect”The normal flow runs inside Codex:
- Ask for an external write. For example: “Push this POC plan to a
Confluence page in the
SEspace.” - Codex verifies that
COMPOSIO_API_KEYis present. - Codex checks whether the
confluencetoolkit is connected. - If it is not, Codex offers
Connect now / Skip. Connect nowopens the Composio hosted login page in a browser tab.- You complete the Confluence OAuth flow — this typically includes picking the Atlassian site and the workspace to connect.
- Codex polls the connected account until it becomes
ACTIVE. - 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.
Connect from the Composio dashboard
Section titled “Connect from the Composio dashboard”- Open the Composio dashboard.
- Go to Connections.
- Find the
confluencetoolkit. - Click Connect and pick the Atlassian site to grant access to.
- Confirm the connection shows as Active.
Which skills write to Confluence
Section titled “Which skills write to Confluence”- 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.
Confirmation rules
Section titled “Confirmation rules”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.
Troubleshooting
Section titled “Troubleshooting”- 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.