Skip to main content

Confluence Integration Manager
App

Resolve common issues when configuring or running the Confluence Integration Manager app. This guide covers credential format, base URL configuration, and authentication failures.

Incorrect confluence username​

danger

Authentication fails or the app can't access Confluence pages.

Cause​

The Confluence Username field must contain the full username. Partial values (for example, john.doe instead of [email protected]) cause authentication failures.

Solution​

  1. Open your Confluence (or Atlassian) account settings and confirm the exact username or email used for login.
  2. In the Confluence Integration Manager workflow, set Confluence Username to that full value (for example, [email protected]).
  3. Don't use partial values such as john.doe or a display name.

Incorrect confluence base URL​

danger

Connection or authentication errors when the app tries to reach Confluence.

Cause​

Confluence Base URL must be only the base domain of your Confluence instance. Including paths (such as /wiki or /test) or the protocol (https://) can cause requests to fail.

Solution​

  1. Identify your Confluence instance URL from the browser when you open Confluence (for example, https://atlanhq.atlassian.net/wiki/...).
  2. In the workflow, set Confluence Base URL to the base domain only: atlanhq.atlassian.net.
  3. Don't append /wiki, /test, or any other path.

Example: If the full URL is https://atlanhq.atlassian.net, enter:

atlanhq.atlassian.net

Authentication fails during test authentication​

danger

Test Authentication in the workflow fails or returns an error.

Cause​

Authentication can fail due to incorrect Confluence username, API token, or base URL. Verifying credentials outside the app helps determine whether the issue is with the credentials or the app.

Solution​

  1. Confirm Confluence Username, Confluence API Token, and Confluence Base URL match the format in Sync Confluence pages to asset Readmes (full username, base domain only, no paths).

  2. Validate credentials manually with the Confluence API using curl. Replace {{username}}, {{password}}, and {{conf_url}} with your Confluence username, API token, and base URL (no path).

curl -u '{{username}}':'{{password}}' \
  -H 'Accept: application/json' \
  'https://{{conf_url}}/wiki/api/v2/pages?limit=1' -LI

Example:

curl -u '[email protected]':'AbcdEFg0123456789' \
  -H 'Accept: application/json' \
  'https://atlanhq.atlassian.net/wiki/api/v2/pages?limit=1' -LI
  1. A successful response returns HTTP 200. If you get 200 with curl but the app still fails, the issue may be with the app or network; if curl fails, fix the credentials or base URL first.

Need help​

If you need assistance after trying these steps, contact Atlan support.

See also​