## Troubleshooting Confluence Integration Manager

URL: https://docs.atlan.com/product/capabilities/discovery/troubleshooting/confluence-integration-manager

> Resolve common issues with Confluence Integration Manager credentials and authentication.

<!--vale off-->

# Confluence Integration Manager 

<!--vale on-->

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 `john.doe@atlan.com`) 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, `john.doe@atlan.com`).
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:

```text
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](https://docs.atlan.com/product/capabilities/discovery/how-tos/sync-confluence-pages-to-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).

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

*Example:*

```bash
curl -u 'john.doe@atlan.com':'AbcdEFg0123456789' \
 -H 'Accept: application/json' \
 'https://atlanhq.atlassian.net/wiki/api/v2/pages?limit=1' -LI
```

3. 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.

If you need assistance after trying these steps, contact [Atlan support](https://docs.atlan.com/support/submit-request).

## See also

- [Sync Confluence pages to asset Readmes](https://docs.atlan.com/product/capabilities/discovery/how-tos/sync-confluence-pages-to-readmes): Configure and run the workflow
- [Add a resource](https://docs.atlan.com/llms/catalog/discovery/add-a-resource/llms.txt): Add Confluence URLs to asset Resources so the app can sync them to Readmes

---