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 *string
API token for Basic auth
Atlassian API token associated with the username; keep in a secret and avoid logging.
serverUrl *string
Set Confluence site URL
Base Confluence site URL (e.g., https://your-domain.atlassian.net) without a trailing slash.
spaceId *string
Target space ID
username *string
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).
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150embedded 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.
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.
