
Atlassian Confluence Create
CertifiedCreate Confluence page from Markdown
Atlassian Confluence Create
Create Confluence page from Markdown
Creates a page in a Confluence space using REST API v2. Renders Markdown to Confluence storage HTML, supports optional status/parent/subtype flags, and passes embedded/private/root-level query parameters. Requires spaceId, title, markdown, and Basic authentication.
type: io.kestra.plugin.confluence.pages.CreateExamples
Create a basic page in a Confluence space.
id: create-confluence-page
namespace: company.team
tasks:
- id: create_page
type: io.kestra.plugin.confluence.pages.Create
serverUrl: https://your-domain.atlassian.net
username: your-email@example.com
apiToken: "{{ secret('CONFLUENCE_API_TOKEN') }}"
spaceId: "123456"
title: My New Page from Kestra
markdown: |
# Kestra-Generated Page
This page was created automatically from a Kestra flow.
- List item 1
- List item 2
Properties
apiToken *Requiredstring
API token for Basic auth
Atlassian API token associated with the username; keep in a secret and avoid logging.
serverUrl *Requiredstring
Set Confluence site URL
Base Confluence site URL (e.g., https://your-domain.atlassian.net) without a trailing slash.
spaceId *Requiredstring
Target space ID
username *Requiredstring
Authentication username (email)
Confluence account email used for Basic authentication; render from secrets where possible.
apiPath string
/wiki/api/v2API base path
Base path appended to the server URL before the resource endpoint. Defaults to /wiki/api/v2 for Confluence Cloud. Override for On-Premise instances (e.g., /rest/api or a custom context root).
embedded booleanstring
Create content as embedded
Sets embedded=true so Confluence stores the page in the new content service. Default: false
makePrivate booleanstring
Make page private
If true, only the creator can view and edit the page until permissions are changed. Default: false
markdown string
Markdown content to upload
Markdown rendered to Confluence storage HTML before sending to the API. Required.
parentId string
Parent page ID
Parent content ID. When rootLevel is false and omitted, Confluence uses the space homepage; ignored when rootLevel is true.
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
rootLevel booleanstring
Create page at space root
Creates the page at the space root (outside the homepage tree) and forbids parentId. Default: false
status string
Page status
Optional page status. Valid values: current, draft. Confluence applies its default when omitted.
subtype string
Page subtype
Optional subtype. Use live to create a collaborative live doc; omit for a regular page.
title string
Page title
Display title for the new Confluence page. Required.
Outputs
value string
Confluence API response
Full JSON response returned by Confluence after the page is created.