---
title: Confluence Cloud Access Requirements
excerpt: ''
deprecated: false
hidden: false
metadata:
  title: ''
  description: ''
  robots: index
next:
  description: ''
---
# Confluence Cloud Access Needs

For Confluence Cloud, Moveworks requires a dedicated Service Account. API access is done via basic auth and requires a **username** and **token**, which needs to be generated by logging in as the Service Account user.

The Service Account must have read access to the necessary Confluence spaces where end-user knowledge articles reside.

The service account can have SSO enabled, as long as you are able to log in on behalf of it. When Moveworks connects to Confluence, it will be leveraging the API token without requiring the local password of the service account.

> 📘 Please note that Global API tokens will not work for the integration.

**Here are the steps to create an API token for a Confluence Service Account:**

1. Log in to [https://id.atlassian.com/manage/api-tokens](https://id.atlassian.com/manage/api-tokens) using the Service Account user credentials.
2. Click Create API token.
3. From the dialog that appears, enter a label for the token (Moveworks) and click Create.
4. Click Copy to clipboard and store the token for the next steps

**More detailed information here:** [https://confluence.atlassian.com/cloud/api-tokens-938839638.html](https://confluence.atlassian.com/cloud/api-tokens-938839638.html)

After creating the token, you can use the curl command below to test that the access is working as expected (be sure to replace `https://company.atlassian.net` with the name of your instance, replace `moveworksaccount@company.com` with the Service account you are using, and replace `my-api-token` with the API token you created following the steps outlined above ):

```
curl -v https://company.atlassian.net/rest/servicedeskapi/servicedesk --user moveworksaccount@company.com:my-api-token
```

# Create the Connector in Moveworks Setup

Navigate to **Core Platform** > **Connectors** > **Built-in Connectors** and create a new connector. Select Confluence and enter the information below:

* **Connection Name**: confluence (recommended)
* **Base Url**: Enter the URL of your Atlassian instance
* **Authentication Type**: Basic Auth
* **Username**: Enter the username of the service account created earlier
* **Password**: Enter the API token created earlier

![](https://files.readme.io/7c27303b95defd234dd52b6bd62ce796cd14a2397c9f660094f62f4b670f44d1-Screenshot_2025-01-30_at_12.20.59_PM.png)