> ## Documentation Index
> Fetch the complete documentation index at: https://koreai-apis.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuring the Confluence Action

<Badge icon="arrow-left" color="gray">[Back to Actions Integrations](/ai-for-service/integrations/overview#actions)</Badge>

Connect the Platform to Confluence to create and view pages or blogs in your Confluence space. See [Confluence documentation](https://support.atlassian.com/confluence-cloud/resources/) for details.

***

## Supported Authorization Types

The platform supports OAuth v2.0 for Confluence integration. See [App Authorization Overview](/ai-for-service/app-settings#authorization-profiles) for details.

| Authorization Type                       | Basic OAuth |
| ---------------------------------------- | ----------- |
| Pre-Authorize the Integration            | Yes         |
| Allow Users to Authorize the Integration | Yes         |

<Note>Confluence integration can be authorized only for Developer and Enterprise editions. Trial edition isn't supported. See [Confluence documentation](https://support.atlassian.com/confluence-cloud/docs/configure-confluence-cloud/) for details.</Note>

***

## Prerequisites

Before enabling Confluence actions:

* Create an Atlassian developer account.
* Create an OAuth app in Atlassian with permission: `write:confluence-content offline_access`. See [Atlassian OAuth documentation](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/#overview).
* Copy the **Client ID**, **Client Secret Key**, **Authorization URL**, and **Callback URL**.

***

## Step 1: Enable the Confluence Action

Go to **App Settings > Integrations > Actions** and select **Confluence**.

### Pre-authorize the Integration (OAuth)

1. In the **Configurations** dialog, select the **Authorization** tab.
2. Set **Authorization Type** to **Pre-authorize the Integration** > **OAuth**.

   <img src="https://mintcdn.com/koreai-apis/wNnu3Aw7k6MpK3Qt/ai-for-service/integrations/actions/images/confluence-action-img2.png?fit=max&auto=format&n=wNnu3Aw7k6MpK3Qt&q=85&s=bf326cec2f9a4cb6bb72d7c8da9c985e" alt="Authorization Type-OAuth" width="953" height="833" data-path="ai-for-service/integrations/actions/images/confluence-action-img2.png" />

**System Authorization**

Use Kore.ai's preconfigured Confluence app:

1. Select the **System** card and click **Authorize**.

   <img src="https://mintcdn.com/koreai-apis/wNnu3Aw7k6MpK3Qt/ai-for-service/integrations/actions/images/confluence-action-img3.png?fit=max&auto=format&n=wNnu3Aw7k6MpK3Qt&q=85&s=2bae19906cadf1801c96f9ea616ecefb" alt="System card" width="953" height="833" data-path="ai-for-service/integrations/actions/images/confluence-action-img3.png" />

2. You are redirected to [https://auth.atlassian.com/authorize](https://auth.atlassian.com/authorize).

3. Enter your developer account credentials.

4. Click **Allow Access** to fetch the access token.

**Custom Authorization**

Create your own authorization profile:

1. Select **Custom** and click **Select Authorization** > **Create New**.

   <img src="https://mintcdn.com/koreai-apis/wNnu3Aw7k6MpK3Qt/ai-for-service/integrations/actions/images/confluence-action-img4.png?fit=max&auto=format&n=wNnu3Aw7k6MpK3Qt&q=85&s=d9d2477d414685625e289d60aa2e20aa" alt="Create new Custom authorization" width="958" height="831" data-path="ai-for-service/integrations/actions/images/confluence-action-img4.png" />

2. Select the authorization mechanism (for example, **OAuth v2**). See [Setting Up Authorization Using OAuth v2](/ai-for-service/app-settings/dev-tools/bot-authorization/setting-up-authorization-using-oauth-v2).

3. Enter the following credentials:

   | Field                  | Description                   |
   | ---------------------- | ----------------------------- |
   | Callback URL           | Your callback URL             |
   | Identity Provider Name | Name of the identity provider |
   | Client ID              | OAuth client ID               |
   | Client Secret          | OAuth client secret           |
   | Authorization URL      | Authorization endpoint URL    |
   | Token Request URL      | Token request endpoint URL    |
   | Scope                  | Required OAuth scopes         |
   | Refresh Token URL      | Token refresh endpoint URL    |

   <img src="https://mintcdn.com/koreai-apis/wNnu3Aw7k6MpK3Qt/ai-for-service/integrations/actions/images/confluence-action-img5.png?fit=max&auto=format&n=wNnu3Aw7k6MpK3Qt&q=85&s=caa9c831eb738a46d4d31c41bea39455" alt="Auth credentials" width="955" height="898" data-path="ai-for-service/integrations/actions/images/confluence-action-img5.png" />

4. Click **Save Auth**, then select the new profile.

   <img src="https://mintcdn.com/koreai-apis/wNnu3Aw7k6MpK3Qt/ai-for-service/integrations/actions/images/confluence-action-img6.png?fit=max&auto=format&n=wNnu3Aw7k6MpK3Qt&q=85&s=b742a45711ff29d5b7312daf5b64305f" alt="Save auth" width="949" height="832" data-path="ai-for-service/integrations/actions/images/confluence-action-img6.png" />

5. Click **Authorize** and enter login credentials.

6. Click **Allow Access** if prompted.

7. Click **Save**. The Integration Successful pop-up appears on first configuration.

   <img src="https://mintcdn.com/koreai-apis/wNnu3Aw7k6MpK3Qt/ai-for-service/integrations/actions/images/confluence-action-img7.png?fit=max&auto=format&n=wNnu3Aw7k6MpK3Qt&q=85&s=bdd462ec575599ea976759b3c9ee7f0e" alt="Save authorization" width="706" height="273" data-path="ai-for-service/integrations/actions/images/confluence-action-img7.png" />

<Note>The Confluence action moves from Available to Configured.</Note>

8. Click **Skip for Now** to install templates later.

### Allow End Users to Authorize (OAuth)

1. In the **Configurations** dialog, select the **Authorization** tab.
2. Set **Authorization Type** to **Allow Users to Authorize the Integration** > **OAuth**.

   <img src="https://mintcdn.com/koreai-apis/wNnu3Aw7k6MpK3Qt/ai-for-service/integrations/actions/images/confluence-action-img8.png?fit=max&auto=format&n=wNnu3Aw7k6MpK3Qt&q=85&s=e5016cb5d50a08415662bbd49a38f891" alt="Allow Users to Authorize" width="958" height="833" data-path="ai-for-service/integrations/actions/images/confluence-action-img8.png" />

**System Authorization**

1. Select the **System** card.
2. Click **Enable** — a link is sent to the end user.
3. The user clicks the link and enters credentials to authorize.

**Custom Authorization**

1. Select **Custom** and click **Select Authorization** > **Create New**, following the instructions in the Custom Authorization section above.

2. You can also select an existing authorization profile.

   <img src="https://mintcdn.com/koreai-apis/wNnu3Aw7k6MpK3Qt/ai-for-service/integrations/actions/images/confluence-action-img9.png?fit=max&auto=format&n=wNnu3Aw7k6MpK3Qt&q=85&s=1d8f85349c69516b69a14eb9004c4537" alt="Select existing profile" width="955" height="828" data-path="ai-for-service/integrations/actions/images/confluence-action-img9.png" />

3. Click **Enable**.

***

## Step 2: Install Confluence Action Templates

1. On the Integration Successful dialog, click **Explore Templates**.

   <img src="https://mintcdn.com/koreai-apis/wNnu3Aw7k6MpK3Qt/ai-for-service/integrations/actions/images/confluence-action-img10.png?fit=max&auto=format&n=wNnu3Aw7k6MpK3Qt&q=85&s=ad262b0e770d51a2a7b385d71a59aeca" alt="Explore Templates" width="706" height="273" data-path="ai-for-service/integrations/actions/images/confluence-action-img10.png" />

2. Click **Install** for the desired template.

   <img src="https://mintcdn.com/koreai-apis/wNnu3Aw7k6MpK3Qt/ai-for-service/integrations/actions/images/confluence-action-img11.png?fit=max&auto=format&n=wNnu3Aw7k6MpK3Qt&q=85&s=1c8cbc28c4296821fd1c17cfc35362bb" alt="Install template" width="693" height="343" data-path="ai-for-service/integrations/actions/images/confluence-action-img11.png" />

3. The associated dialog task is auto-created. Click **Go to Dialog** or navigate to **Automation AI > Use Cases > Dialogs**.

4. To use the templates, see [Using Confluence Action Templates](/ai-for-service/integrations/actions/using-the-confluence-action-templates).
