n8n-nodes-confluence-v2

This is an n8n community node for working with Atlassian Confluence using the V2 REST API.

Features

- ✅ V2 API Support: Uses the latest Confluence REST API v2
- ✅ Hierarchy Support: Fetch pages with their complete folder structure
- ✅ Depth Control: Configure how deep to fetch (full depth or limited)
- ✅ Pages & Folders: Supports both pages and folder content types
- ✅ Flexible Operations: Get flat lists or hierarchical structures

Installation

Follow the installation guide in the n8n community nodes documentation.

1. Make sure community nodes are enabled: N8N_COMMUNITY_PACKAGES_ENABLED=true
2. In n8n, go to Settings → Community Nodes
3. Install: n8n-nodes-confluence-v2

Operations

$3

List all Confluence spaces or filter by specific space keys.

Options:
- Space Keys: Comma-separated list of space keys to filter (e.g., SPACE1,SPACE2). Leave empty to retrieve all spaces.
- Limit: Maximum number of spaces to return (default: 50, max: 250)

Output:
Returns space metadata including:
- Space ID, key, name, and type (personal/global)
- Owner ID and author ID
- Creation date and status
- Homepage ID and description
- Web UI links

$3

Get all pages in a Confluence space as a flat list.

Options:
- Space ID: The ID of the Confluence space (required)
- Include Hierarchy: Optionally fetch children for each page
- Depth Control: Full depth or limited depth
- Max Depth: Limit how many levels deep to fetch (1-10)
- Limit: Number of pages per request (default: 250, max: 250)

$3

Get pages organized in their folder structure (hierarchical tree).

Options:
- Space ID: The ID of the Confluence space (required)
- Depth Control: Full depth or limited depth
- Max Depth: Limit how many levels deep to fetch (1-10)
- Limit: Number of pages per request (default: 250, max: 250)

Credentials

This node requires Confluence API credentials:

1. Base URL: Your Confluence instance URL
- Format: https://your-domain.atlassian.net/wiki
2. Email: Your Atlassian account email
3. API Token: Generate from Atlassian API Tokens

Output Structure

$3

``json
{
"id": "196610",
"key": "~7120203b4741fcaf6a40e4bed1d04bcdb2f7f7",
"name": "Abdul Wasay Mir",
"type": "personal",
"status": "current",
"spaceOwnerId": "712020:3b4741fc-af6a-40e4-bed1-d04bcdb2f7f7",
"authorId": "712020:3b4741fc-af6a-40e4-bed1-d04bcdb2f7f7",
"createdAt": "2025-11-03T21:23:21.076Z",
"homepageId": "196710",
"description": null,
"_links": {
"webui": "/spaces/~7120203b4741fcaf6a40e4bed1d04bcdb2f7f7"
}
}
`

$3

`json
{
"id": "123456",
"title": "My Page",
"type": "page",
"parentId": "789",
"parentType": "page",
"spaceId": "SPACE",
"status": "current",
"createdAt": "2024-01-01T00:00:00.000Z",
"authorId": "user123"
}
`

$3

`json
{
"id": "123456",
"title": "Parent Page",
"type": "page",
"spaceId": "SPACE",
"depth": 0,
"children": [
{
"id": "789",
"title": "Child Page",
"type": "page",
"parentId": "123456",
"depth": 1,
"children": []
}
]
}
`

API Version

This node uses Confluence REST API v2 endpoints:
- /api/v2/spaces - List spaces
- /api/v2/spaces/{id}/pages - Get pages in space
- /api/v2/pages/{id}/children - Get page children
- /api/v2/pages/{id} - Get single page

Compatibility

- n8n version: 0.125.0+
- Node version: 1.0.0
- Tested with: n8n Cloud and self-hosted instances

Development

`bash


Install dependencies

npm install

Build

npm run build

Watch mode

npm run dev

Lint

npm run lint
``

License

MIT

Support

For issues and feature requests, please visit the GitHub repository.

Changelog

See CHANGELOG.md for detailed version history.

$3

- Fixed duplicate Limit parameter on Get Spaces operation
- Icon display working correctly

$3

- Added Get Spaces operation with filtering support
- List all Confluence spaces or filter by space keys

$3

- V2 API support
- Hierarchy fetching with depth control
- Pages and folders support
- Two operations: Get Pages and Get Page Hierarchy