APIs & Integrations
Confluence Data Center
Overview
Pre-built tooling
Pre-built integrations
No pre-built integration yet (time to contribute: <48h)
Not seeing the integration you need? Build your own independently.
Access requirements
| Pre-Requisites | Status | Comment |
|---|---|---|
| Paid dev account | ⚠️ Conditional | Confluence Data Center requires a valid license. You can start a free trial for development. |
| Paid test account | ⚠️ Conditional | Same as above. A valid license is needed for test environments. |
| Partnership | ✅ Not required | Atlassian partnership is not required to build or test apps on Data Center. |
| App review | ✅ Not required | App review is not mandatory unless publishing to the Atlassian Marketplace. |
| Security audit | ✅ Not required | A security audit is only required if submitting to the Marketplace under certain programs. |
Setup guide
1
Set up Confluence Data Center
- Ensure you have a running Confluence Data Center instance. If not, you can:
- Make sure you have administrator privileges on your Confluence Data Center instance.
2
Create an incoming link
- Log in to your Confluence Data Center instance as an administrator.
- Navigate to Administration menu > General Configuration > Application links.
- Select Create link.
- Select External application and then choose Incoming as the direction.
- Fill in the details as described in the sections below.
3
Provide application details
In the application details section:
- Enter a descriptive name for your application.
- For the Redirect URL, enter
https://api.nango.dev/oauth/callback.
Note: This is the URL where users will be redirected after authorizing your application.
4
Configure application permissions
Select the appropriate permission scopes for your integration:
- READ: View projects and issues the user can view, including related items like dashboards, filters, attachments, or comments.
- WRITE: Create, update, and delete projects and issues the user can change, including related items.
- ADMIN: Perform most administrative functions on the entire Confluence instance.
- SYSTEM_ADMIN: Perform all administrative functions on the entire Confluence instance.
Note: Choose only the scopes your application needs. Higher-level scopes automatically include lower-level ones (e.g., WRITE includes READ).
5
Obtain OAuth credentials
- After creating the incoming link, you’ll receive your OAuth credentials:
- Client ID: The identifier for your application
- Client Secret: The secret key for your application
- Store these credentials securely as you’ll need them to configure your integration in Nango.
6
Next
Follow the Quickstart.
Need help getting started? Get help in the community.
Useful links
Contribute useful links by editing this page
API gotchas
- Confluence Data Center may be installed with a context path (e.g.,
/confluence) or without one. This affects your API endpoints within Nango. With context:/confluence/rest/api/..., or Without context:/rest/api/.... Make sure your integration uses the correct one depending on how your Confluence instance is deployed.
Contribute API gotchas by editing this page
Going further
Connect to Confluence Data Center
Guide to connect to Confluence Data Center using Connect UI