Description

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

Get Spaces

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

Get Pages in Space

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)

Get Page Hierarchy

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

Get Spaces

{
  "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"
  }
}

Get Pages (Flat List)

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

Get Page Hierarchy

{
  "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

# 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.

Latest: 0.2.1

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

0.2.0

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

0.1.0 (Initial Release)

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