Confluence Integration
Requirements
- Base URL
- Username
- API Token
- Space Key
1. Base URL
The Base URL is the root web address of your Atlassian instance. Capacity uses this to locate and connect to your Confluence environment.
How to find it: Look at the address bar in your browser while viewing any page in Confluence.
- Format:
https://your-domain.atlassian.net/wiki
2. Username
For Confluence Cloud, the Username used for API authentication is the email address associated with your Atlassian account — not a display name or handle.
How to find it: This is the email address you use to log in to Atlassian (e.g., name@company.com).
- To verify: click your profile icon in the bottom-left corner of Confluence, select Profile, and confirm the email address listed there.
3. API Token
Confluence Cloud does not allow standard login passwords to be used for API access. You must generate a dedicated API token from your Atlassian account settings.
How to generate a token:
- Go to id.atlassian.com/manage-profile/security/api-tokens.
- Click Create API token.
- Give the token a recognizable label (e.g.,
Capacity-Integration) and click Create. - Copy the token immediately — you cannot view it again after closing the confirmation popup.
You cannot view the token again after closing the confirmation popup. If it is lost, you will need to revoke it and generate a new one.
4. Space Key
A Space Key is a short, unique identifier for a specific area of Confluence (e.g., ENG for Engineering or MKT for Marketing). Capacity uses the Space Key to scope indexing to the correct content area.
How to find it:
- Navigate to the Confluence Space you want to connect.
- Click Space settings in the left-hand sidebar.
- Under Space details, look for the Key field — that value is your Space Key.
Note: Each Capacity connector configuration maps to a single Space Key. To index multiple spaces, each space will need its own connector configuration. Contact your CSM to discuss multi-space setups.