---
name: docs/confluence-official:page-create
description: Create a new Confluence page
version: "0.5.0"
---

> **Backend:** confluence-official (atlassian@claude-plugins-official)
> **Note:** Requires `atlassian@claude-plugins-official` plugin. Install: `/plugin install atlassian@claude-plugins-official`

# Page Create

## Rules

- **IMPORTANT**: Page titles must NOT contain colons (`:`). The Confluence API rejects them. Replace `:` with `-` in all titles. Example: use `"PRD - Feature Name"` not `"PRD: Feature Name"`.

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| space_key | string | Yes | Confluence space key (e.g., `<CONFLUENCE_SPACE_KEY>`) |
| title | string | Yes | Page title (no colons) |
| body | string | Yes | Page content in Confluence storage format |
| parent_id | string | No | Parent page ID to nest the new page under |
| labels | string[] | No | Labels to apply to the page on creation |

## Implementation

Uses MCP Confluence tool: `mcp__atlassian__createConfluencePage`

## Output

| Field | Type | Description |
|-------|------|-------------|
| id | string | Newly created page ID |
| title | string | Title of the created page |
| url | string | URL to the created page |
| version | number | Initial version number (always 1) |

## Errors

| Code | Cause | Recovery |
|------|-------|----------|
| TITLE_CONFLICT | A page with the same title already exists in the space | Choose a unique title or use `confluence-official:page-update` |
| INVALID_TITLE | Title contains a colon or other disallowed character | Replace `:` with `-` in the title |
| PARENT_NOT_FOUND | parent_id does not exist | Verify parent_id with `confluence-official:page-read` |
| PERMISSION_DENIED | Token lacks create access to the space | Check plugin configuration and Confluence token scopes |
| PLUGIN_UNAVAILABLE | atlassian@claude-plugins-official plugin is not installed or not responding | Run `/plugin install atlassian@claude-plugins-official` and retry |

## Used By

- design-solution (creating specification pages in Confluence)
- design-feature (creating feature planning pages)
