For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Skip to content

Set up Confluence

Confluence setup for your AI agent, screen by screen: create an Atlassian API token, then connect it in eesel, with a screenshot for each step.

Setting up Confluence for your AI agent takes one API token from Atlassian and one secure form in eesel. An API token is a password-like key that lets eesel read Confluence. You create the token in your Atlassian account, then paste it into eesel with your Confluence subdomain and email.

There is no Atlassian Marketplace app to install.

Before you begin

  • You need a Confluence Cloud site, at an address like yourcompany.atlassian.net. If your Confluence address does not end in .atlassian.net, get in touch.

  • Pick the Atlassian account your agent will use. Your agent signs in as this account, so it sees only what this account sees. The account needs a Confluence licence, a seat with access to Confluence, and must be able to open the spaces you want answered from.

  • Have your subdomain ready. It is the part before .atlassian.net in your Confluence address. Use yourcompany, not yourcompany.atlassian.net.

Walkthrough

1

Open your Atlassian API tokens page

Sign in to Atlassian as the account your agent will use. Open your API tokens page. You can also get there from your Atlassian account: open Security, then API tokens.

The API Tokens page in Atlassian account settings under Security, with Create API token and Create API token with scopes buttons and a list of existing tokens
The API tokens page in your Atlassian account.

Click Create API token. Do not use Create API token with scopes. eesel needs the plain token.

2

Name the token and pick an expiry

Give the token a name your team will recognise, for example eesel Confluence. Pick an expiry date, then click Create.

The Create an API token dialog in Atlassian, with the name eesel Confluence filled in, an expiry date, and a Create button
The Create an API token dialog, with a name and an expiry date.

Atlassian allows up to one year. A longer expiry means you reconnect less often. When the token expires, your agent stops reading Confluence until you connect again with a new token.

3

Copy the token

Atlassian shows the new token once. Click Copy, then click Done.

The Copy your API token dialog in Atlassian, with the token masked, a Copy button and a Done button
The new token, masked, with the Copy button beside it.
4

Ask your agent to connect Confluence

In the eesel dashboard, ask your agent in the chat to connect Confluence. It opens a secure form with one field for the token, and asks for your subdomain and email in the chat.

The dashboard chat where the user asks to connect Confluence, and the agent shows a secure form with an Atlassian API token field and asks for the Confluence subdomain and the Atlassian account email
The agent opens a secure form for the token and asks for two details.

Prefer to click? Open Integrations in the left sidebar, pick Confluence, then choose API token. It asks for the same three things in one form.

5

Paste the token into the secure form

Paste the token into the form and click Save securely.

The secure form in the dashboard chat with the token pasted in and masked, and the Save securely button ready to click
The form filled in, with the token masked.

A person always pastes the token in. If an AI tool such as Claude Code runs the setup, it waits for you to do this step.

6

Give your subdomain and email

Reply in the chat with your subdomain and the email on the Atlassian account that made the token. Your agent connects, then lists the spaces it can read to show the connection works.

The dashboard chat where the user gives the subdomain and email, and the agent confirms Confluence is connected and lists four spaces it can read
The agent confirms the connection and lists the spaces it can see.

Check it worked. Confluence (API token) appears in the left sidebar. Open it to see the connection and the actions your agent can take. From a terminal, eesel status lists the integration as connected.

The Confluence (API token) integration page in eesel, marked Connected with the site name, and a Read group of four actions: Get Confluence Page, List Child Pages, List Confluence Spaces and Search Confluence
The integration page, with the four read actions your agent can use.

eesel does not copy your pages. Your agent reads Confluence live each time it answers.

Troubleshooting

The connection fails
  • Check the subdomain is only the part before .atlassian.net.

  • Check the email is the one on the Atlassian account that made the token, not a team alias.

  • Check you used Create API token, not Create API token with scopes.

  • New tokens can take up to a minute to work. Wait a minute and connect again.

It worked, then every Confluence answer started failing

The token has probably expired, or someone revoked it. Create a new token and ask your agent to connect Confluence again.

Connected, but your agent cannot find a page

Your agent sees what the connected account sees. Check that account can open the space and the page in Confluence. The account also needs a Confluence licence. An account that only has Jira can sign in but cannot read Confluence.

FAQ

Is it safe to give eesel a Confluence API token?

Yes. The token goes into a secure form, straight to eesel, never into the chat, and the form expires in 30 minutes. Your agent reads Confluence, and can create a page or change one's title or body as the connected account. eesel's safety check holds a risky change for your approval, unless you set those actions to ask you first.

Can I use the same token for Jira and Confluence?

Yes, if the account has both a Jira and a Confluence licence. It is the same kind of Atlassian API token. A separate token for each makes it easier to revoke one without breaking the other.

Last updated