---
title: "Confluence"
section: "Integrations"
description: "Set up the SmartestQA Confluence integration: API token, space key, parent page IDs, sending test reports and documentation, automatic report pages and mappings."
url: https://docs.smartestqa.ai/en/integrations-confluence.html
audience: [customer, admin]
updated: 2026-11-08
keywords: "confluence cloud api token space key parent page id test report page documentation export auto create report pages mapping atlassian"
---
# Integrations: Confluence

The Confluence integration writes SmartestQA content into Confluence Cloud: one page per finished run under a reports page, and one page per test case under a documentation page.

## In short

**On this page you can**

- Create a Confluence page for every finished run that has no page yet.
- Create a report page automatically when a pipeline finishes.
- Export every test case as a documentation page, and update it later.
- Change the parent page of each category directly on the page.
- Open or delete the links between SmartestQA items and Confluence pages.

**How to use it**

1. Create an Atlassian API token and find the space key and parent page IDs.
2. Click Setup , enter URL, email and token, then Test Connection .
3. Enter the Default Space Key and the parent page IDs.
4. Choose the sync features, turn on Enable Integration and save.
5. Click Send Report and open the new page in Confluence.

## Before you start

- **Confluence Cloud.** The integration uses the Confluence Cloud REST API with email and API token.
- **An API token** for a technical Atlassian account, from [Atlassian account › Security › API tokens](https://id.atlassian.com/manage-profile/security/api-tokens). The dialog links to it with **Create API Token**.
- **A space key**, for example `QA`, where that account can create pages.
- **Parent page IDs.** Create one page for reports and one for documentation. The ID is the number in the page URL: in `…/wiki/spaces/QA/pages/123456789/Test+Reports` it is `123456789`.

## Set up Confluence

1. **Connection Settings**

   Click **Setup**. In **Confluence Integration Configuration** enter **Confluence URL** (for example `https://your-site.atlassian.net`), **Email** and **API Token**. Click **Test Connection**.

   **Connection Successful**. **Next** works only after this.
2. **Space & Pages**

   Enter the **Default Space Key** and under **Parent Page ID Settings** the **Reports Parent Page ID** and **Documentation Parent Page ID**. **Requirements Parent Page ID** is for [requirement import](https://docs.smartestqa.ai/en/integrations-confluence.html#import-requirements), which the page does not offer yet.
3. **Sync Settings**

   Under **Sync Features** turn on **Test Reports Sync** and **Documentation Sync**. Turn on **Auto-Create Report Pages** to get a page after every [pipeline](https://docs.smartestqa.ai/en/schedule-create.html). Keep **Enable Integration** on and click **Save**.

   “Confluence settings saved” and the page shows **Active**.

## What is sent and when

| Action | What happens in Confluence | Needs |
| --- | --- | --- |
| **Send Report** | For every finished run of the project that has no page yet under the current reports parent page, one page is created. Runs still running are skipped. | **Test Reports Sync** |
| A [pipeline](https://docs.smartestqa.ai/en/schedule-create.html) finishes | One report page for that run. | **Test Reports Sync** and **Auto-Create Report Pages** |
| **Send All Test Case Docs** | One page per test case under the documentation parent. A test case that already has a page gets that page updated, and moved if you changed the parent. | **Documentation Sync** |
| Requirements Import | Shown as **Coming soon**, with no button. An AI assistant can still start it; see [Requirement import](https://docs.smartestqa.ai/en/integrations-confluence.html#import-requirements). | The card’s switch on and a **Requirements Parent Page ID** |

A report page is titled `pipeline - yyyy-MM-dd HH:mm [last 8 characters of the run id]`. If Confluence already has a page with that title, SmartestQA adds “ (2)”, “ (3)” and so on. When nothing is new, the message reads “No new reports to send (total: *n* reports, mapped: *m*, running: *r*)”.

Only one sync runs at a time per project. A second one gets “Zaten bir senkronizasyon devam ediyor” (a sync is already running, shown in Turkish in this version). A sync that has held the lock for 60 minutes is released.

> **Tip: Changing the reports parent page**
>
> “Already sent” is counted per parent page. If you point **Reports Parent Page** at a new page, the next **Send Report** publishes every finished run again under the new parent. Use that to rebuild a report tree; avoid it on a project with hundreds of runs.

### Requirement import

The page offers no requirement import yet: the **Requirements Import** card shows **Coming soon** instead of a [**Pull Requirements**](https://docs.smartestqa.ai/en/analyze.html#alternatives) button. The server can import, and an AI assistant connected through [MCP](https://docs.smartestqa.ai/en/mcp.html) can start it (`smartest_integrations`, `sync` with target `requirements`). Turn on the card’s switch and set its parent page first. Each child page of the **Requirements Parent Page ID** becomes a main requirement (title and text) in a **Confluence Import** folder of [Analyze](https://docs.smartestqa.ai/en/analyze.html); a page imported before updates its requirement.

## The Confluence page

- **KPIs**: **Total Mappings**, **Test Cases**, **Test Reports**, **Requirements**. See [how they are counted](https://docs.smartestqa.ai/en/integrations-numbers.html#confluence-kpis).
- ****Connection Status****: **Confluence Integration** (Synchronization enabled or disabled), **Confluence Space**, **Last Sync**.
- ****Synchronization** tab**: one card each for **Requirements Import**, **Test Reports** and **Documentation**. Each card has its sync switch and its parent page, which you change with **Edit** and save in place. The Test Reports card also has **Auto create reports**.
- ****Mappings** tab**: sections **Test Case**, **Test Report** and **Requirement**, with search, **Open in Confluence** and **Delete Mapping**.

Switches and parent page edits save at once; a failure shows “Update failed”. Deleting a mapping only removes the link; the page stays in Confluence, and the item gets a new page on the next send.

**Remove** asks “Are you sure you want to remove the Confluence integration? All mappings will be deleted.” Pages in Confluence stay.

## If something goes wrong

- [“Kimlik dogrulama hatasi. Email ve API token kontrol edin.”](https://docs.smartestqa.ai/en/integrations-troubleshooting.html#fix-confluence-auth)
- [“Space not found”](https://docs.smartestqa.ai/en/integrations-troubleshooting.html#fix-confluence-space)
- [“Could not send report. Check reportsParentPageId setting.”](https://docs.smartestqa.ai/en/integrations-troubleshooting.html#fix-confluence-report)
- [“Reports sync disabled” / “Documentation sync disabled”](https://docs.smartestqa.ai/en/integrations-troubleshooting.html#fix-confluence-disabled)
