> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Confluence

> Manage Confluence spaces, pages, blog posts, labels, properties, and tasks via your connected account.

Use Confluence when your workflow needs to create or update pages, blog posts, spaces, labels, properties, or tasks. It also works well when you need to search or fetch existing content before taking action.

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | Label for the step in the workflow canvas. |
| Authentication | Yes | The connected Confluence account to use for this step. |
| Action | Yes | The Confluence action to perform (for example Get current user, List spaces, Get space, Search spaces). |
| Arguments | Yes | Per-action form fields generated from the action's schema. Each text field has an **Insert Variable** button for injecting `{{placeholder}}` values. A **Raw JSON** tab is available for advanced usage. |
| When the step fails | No | Controls whether the workflow should **Terminate Workflow** or **Continue** if this step fails. |

Before you configure this step, connect Confluence in **Integrations** for your workspace using the sign-in flow. If no active connection is available, the step shows a warning with a link to **Integrations** instead of the account selector.

## Arguments form

When you select an action, the **Arguments** section renders a form driven by the action's input schema. Fields that refer to existing records include dropdown pickers.

Switch to the **Raw JSON** tab when you prefer to write the full arguments object by hand. Changes in either tab stay in sync.

## Common actions

| Action | Description |
| - | - |
| **Get current user** | Return the connected Confluence user and account details. |
| **List spaces** | List the spaces visible to the connected user. |
| **Get space** | Get details for a space by its ID. |
| **Search spaces** | Search spaces by name, key, type, status, or labels. |
| **Create space** | Create a new space with a key and name. |
| **Create private space** | Create a private space with a key and name. |
| **List pages** | List pages in Confluence. |
| **Get page** | Get a page by its ID. |
| **Search pages** | Search pages by title, space, or status. |
| **Create page** | Create a new page in a space. |
| **Update page** | Update an existing page title or body. |
| **List child pages** | List the direct child pages of a page. |
| **List page versions** | List all versions of a page. |
| **Get page labels** | Get the labels applied to a page. |
| **Add content label** | Add labels to a piece of content. |

Destructive actions, such as deleting records, are not available in the workflow action picker.

## Output

This step stores the Confluence response as the step output. The shape of the response depends on the action.

Use the full output reference in later steps:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Example

1. Open **Integrations** and connect Confluence if you have not already done that.
2. Add a **Confluence** step to your workflow.
3. Select a connected account in **Authentication**.
4. Choose **Get current user** in **Action**.
5. Fill in the required fields. Use **Insert Variable** to reference an earlier step's output for any field value.
6. Click **Run** in the step header to test the action, then review the returned payload in **Output**.

## Use cases

### Create a project page

1. List spaces
2. Get space
3. Create page

### Update a tracked task

1. List tasks
2. Update task

### Organize content with labels

1. Search pages
2. Get page labels
3. Add content label

## Notes

* This step depends on a connected Confluence integration in your workspace.
* The workflow action picker shows a curated set of actions. Agents with the Confluence tool can use more of them.
* The sign-in screen may show third-party authorization branding.

## Using Confluence as an Agent Tool

You can also add Confluence as a tool in the **Agent Editor**. Open the agent, click **Add tool**, and select **Confluence**. In the tool settings panel, choose the connected account the agent should use. The agent calls Confluence actions when they are relevant to the conversation.

See also: [Integrations](https://docs.fetchhive.com/workspace/integrations.md), [Creating and Editing](https://docs.fetchhive.com/workflows/creating-and-editing.md), and [Testing and Iteration](https://docs.fetchhive.com/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.