# Confluence — Pipedream Connect

> Get, create, update, and delete content, spaces, and more.

- API slug: `confluence` (use in MCP headers and tool keys)
- Auth: OAuth (Pipedream-managed)
- Categories: Productivity
- Website: https://www.atlassian.com/software/confluence
- Managed OAuth scopes: `read:confluence-content.all` · `search:confluence` · `read:me` · `offline_access` · `read:space:confluence` · `read:blogpost:confluence` · `write:blogpost:confluence` · `delete:blogpost:confluence` · `read:page:confluence` · `write:page:confluence` · `write:confluence-content`
- This page (HTML): https://pipedream.com/apps/confluence
- Tools: 11 actions · 3 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: confluence`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "confluence",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Create Page:
const result = await mcp.callTool({
  name: "confluence-create-page",
  arguments: {
    spaceId: "Space ID",
    title: "Title",
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a Confluence endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://api.atlassian.com/me

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkuYXRsYXNzaWFuLmNvbS9tZQ?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "confluence-create-page",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    confluence: { authProvisionId: "apn_xxxxxxx" },
    spaceId: "Space ID",
    title: "Title",
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (11)

### `confluence-create-page` — Create Page (Write)

Creates a new page in the space. See the documentation

Full schema: https://pipedream.com/apps/confluence/actions/create-page.md

### `confluence-create-post` — Create Post (Write)

Creates a new page or blog post on Confluence. See the documentation

Full schema: https://pipedream.com/apps/confluence/actions/create-post.md

### `confluence-delete-post` — Delete Post (Write)

Removes a blog post from Confluence by its ID. Use with caution, the action is irreversible. See the documentation

Full schema: https://pipedream.com/apps/confluence/actions/delete-post.md

### `confluence-get-current-user` — Get Current User (Read-only)

Returns the authenticated Confluence user's account ID, display name, email, and cloud ID. Call this first when the user says 'my pages', 'my posts', or needs to scope queries to themselves. Use the returned accountId to filter results from Search Content or Get Pages. See the documentation.

Full schema: https://pipedream.com/apps/confluence/actions/get-current-user.md

### `confluence-get-page-by-id` — Get Page by ID (Read-only)

Retrieve a page by its ID. See the documentation

Full schema: https://pipedream.com/apps/confluence/actions/get-page-by-id.md

### `confluence-get-pages` — Get Pages (Read-only)

Retrieve a list of pages. See the documentation

Full schema: https://pipedream.com/apps/confluence/actions/get-pages.md

### `confluence-get-pages-in-space` — Get Pages in Space (Read-only)

Retrieve a list of pages in a space. See the documentation

Full schema: https://pipedream.com/apps/confluence/actions/get-pages-in-space.md

### `confluence-list-post-id-options` — List Post ID Options (Read-only)

Retrieves available options for the Post ID field.

Full schema: https://pipedream.com/apps/confluence/actions/list-post-id-options.md

### `confluence-list-spaces` — List Spaces (Read-only)

List all spaces in Confluence. See the documentation

Full schema: https://pipedream.com/apps/confluence/actions/list-spaces.md

### `confluence-search-content` — Search Content (Read-only)

Searches for content using the Confluence Query Language (CQL). See the documentation

Full schema: https://pipedream.com/apps/confluence/actions/search-content.md

### `confluence-update-post` — Update a Post (Write)

Updates a page or blog post on Confluence by its ID. See the documentation

Full schema: https://pipedream.com/apps/confluence/actions/update-post.md

## Triggers (3)

### `confluence-new-page-or-blog-post` — New Page or Blog Post (Polling)

Emit new event whenever a new page or blog post is created in a specified space

Full schema: https://pipedream.com/apps/confluence/triggers/new-page-or-blog-post.md

### `confluence-watch-blog-posts` — Watch Blog Posts (Polling)

Emit new event when a blog post is created or updated

Full schema: https://pipedream.com/apps/confluence/triggers/watch-blog-posts.md

### `confluence-watch-pages` — Watch Pages (Polling)

Emit new event when a page is created or updated in Confluence

Full schema: https://pipedream.com/apps/confluence/triggers/watch-pages.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt