Confluence
What Paperbeam reads from Confluence, the read-only access it asks for and why, filters, and the beats it feeds.
Docs & knowledge
Read-only API key
Pages published or updated, blog post announcements and (optionally) comments in the Confluence spaces you choose.
What we read
- Pages and documents you share
- Messages in the channels you choose
Only the reporting window of each edition is read. Paperbeam stores derived facts and short excerpts, not copies of your Confluence data, and keeps raw evidence only for your retention period.
Access we ask for, and why
| Scope | Why |
|---|---|
read:page:confluence | Read pages and blog posts edited in the window (title and a text excerpt) |
read:space:confluence | Resolve the spaces you choose and show space names |
read:user:confluence | Show who published or edited a page |
search:confluence | Comments stream (optional): find comments added in the window |
All access is read-only. You can revoke it from Confluence at any time, or disconnect the source in Paperbeam.
Connect Confluence
- Go to Sources and choose Confluence.
- Create a api token. Atlassian account → Security → Create and manage API tokens → Create API token (the account's Confluence space permissions apply). Open Confluence settings.
- Fill in Site, Email and API token, then click Test connection. Paperbeam makes one read-only call and shows the account it reached, or exactly what went wrong.
- Click Connect. The credential is encrypted before it is stored and never shown again. Use Sync now on the source’s page to see what it collects from the last 24 hours, and set filters there.
You need the admin or owner role in Paperbeam, and enough permission in Confluence to grant read access to the data listed above.
Filters
Set on the source’s page at Sources›Confluence. Filtered-out data is never collected.
| Filter | Effect |
|---|---|
| Spaces | Only pages, blog posts and comments in these space keys. Leave empty for every space the account can see. |
To keep specific people, channels or topics out of the paper across all sources, use exclusion rules and the never-mention list in House style.
Beats
Confluence is a source for:
Stories land in whichever of your sections fits them best.