PluginsPlugin ConfluenceConfluence Pages

Create

Create a Confluence Page

This task creates a new page in a Confluence space. It uses Markdown for the page content, which is automatically converted to Confluence's storage format. You can specify the page title, space, parent page, and more. This task utilizes the Confluence REST API v2.

yaml
type: "io.kestra.plugin.confluence.pages.Create"

Examples

Create a basic page in a Confluence space.

yaml
id: "create"
type: "io.kestra.plugin.confluence.pages.Create"
id: create-confluence-page
namespace: company.team

tasks:
  - id: 1
    type: io.kestra.plugin.confluence.pages.Create
    serverUrl: https://your-domain.atlassian.net
    username: your-email@example.com
    apiToken: {{ secret('CONFLUENCE_API_TOKEwN') }}
    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

Confluence API Token for authentication.

API token generated in Confluence (Atlassian account) used for authentication.

serverUrl *string

URL of the Confluence server.

Base URL of the Confluence instance (e.g., https://your-domain.atlassian.net/wiki).

spaceId *string

Space ID

username *string

Username (email) for authentication.

Confluence account email address used for API authentication.

embedded booleanstring

Embedded Content

Tags the content as embedded, which will cause it to be created in NCS. Default: false

makePrivate booleanstring

Make Page Private

If true, the page will be private. Only the user who creates the page will have permission to view and edit it. Default: false

markdown string

Markdown Content to Upload

The Markdown content to publish on the page.

parentId string

Parent Page ID

The parent content ID of the page. If the 'root-level' query parameter is set to false and a value is not supplied, the space homepage's ID will be used. If the 'root-level' query parameter is set to true, a value cannot be supplied for this parameter.

rootLevel booleanstring

Create at Root Level

If true, the page will be created at the root level of the space (outside the space homepage tree). A value may not be supplied for the parentId parameter when this is true. Default: false

status string

Page Status

The updated status of the page. Valid values: current, draft.

subtype string

Page Subtype

The subtype of the page. Provide 'live' to create a live doc, or no subtype to create a regular page. Valid values: live

title string

Page title filter.

Filter the results to pages that exactly match this title.

Outputs

value string

The API response from Confluence.

Contains the full JSON response from the Confluence API after creating the page.

​Create

Create