Introduction
To enable the Confluence Cloud connector, you need a service account along with three pieces of information: a Confluence site URL, username, and Confluence API token. Note that a Managed Account is required to connect DX Data Cloud.
Steps to connect
Step 1 must be completed by a Confluence admin.
Step 1
Create a Confluence service account to be used for the DX Data Cloud connection. The service account must have access to the spaces that you want to import. The more granular API permissions or scopes to configure are found in the API Reference table below.
Step 2
Create an API token from the Account Security section and copy your token into your notes to use it in the next step.
Step 3
Navigate to the Data Cloud > Connections screen within DX, then add a connection using your credentials generated in the previous steps.
ℹ️ Enter your email address, base URL will be an Atlassian url and API token will be a string beginning with 'ATATT3x'
API Reference
Here is a list of the endpoints we reference while importing data from Confluence
Endpoint URL | Documentation Link |
/wiki/api/v2/spaces | |
/wiki/api/v2/pages | |
/wiki/api/v2/pages/{pageId}/versions | |
/wiki/api/v2/pages/{pageId}/labels | |
/wiki/api/v2/users-bulk |
Errors
This table lists error codes that you may encounter when adding a connection in DX.
Error | Description |
| Your API credentials entered are not valid. |
| Your API token does not have the permissions required by DX. |
Troubleshooting
User filtering doesn't work
DX matches Confluence user emails with DX user emails to map user identities and teams. DX can only import Confluence user emails when profile visibility is set to public, which is the default for Managed accounts but not for Unmanaged accounts.
If your Confluence workspace is currently an Unmanaged account, please migrate to a Managed account to enable the importing of new user emails.