Create

Create a Notion page

Creates a new page in Notion with the specified title and markdown content. Optionally specify a parent page for hierarchical organization.

yaml
type: "io.kestra.plugin.notion.page.Create"

Examples

Create a simple page

yaml
id: notion_create_page
namespace: company.team

tasks:
  - id: create_page
    type: io.kestra.plugin.notion.page.Create
    apiToken: "{{ secret('NOTION_API_TOKEN') }}"
    title: "Meeting Notes"
    content: |
      # Meeting Notes - {{ now() }}

      ## Attendees
      - John Doe
      - Jane Smith

      ## Action Items
      - [ ] Review proposal
      - [ ] Schedule follow-up

Create a page with parent

yaml
id: notion_create_child_page
namespace: company.team

tasks:
  - id: create_child_page
    type: io.kestra.plugin.notion.page.Create
    apiToken: "{{ secret('NOTION_API_TOKEN') }}"
    title: "Sprint Planning"
    parentPageId: "12345678-1234-1234-1234-123456789abc"
    content: |
      # Sprint Planning

      **Sprint Goal:** Improve user authentication

      ## Stories
      - Implement OAuth2
      - Add password reset

Properties

title *string

Page title

The title of the new page

apiToken string

Notion API token

The Notion API integration token (Internal Secret connection)

content string

Page content

The content of the page in markdown format

options HttpConfiguration

The HTTP client configuration.

parentPageId string

Parent page ID

Optional parent page ID for creating a child page. If not specified, the page will be created at the workspace root.

Outputs

archived boolean

Archived

Whether the page is archived

content string

Content

The page content in markdown format

createdTime string

Format date-time

Created Time

When the page was created

lastEditedTime string

Format date-time

Last Edited Time

When the page was last edited

message string

Message

Operation result message

pageId string

Page ID

The unique identifier of the created page

properties object

Properties

Page properties returned by Notion

title string

Page Title

The title of the created page

url string

Page URL

The URL of the created page in Notion

Definitions

io.kestra.core.http.client.configurations.TimeoutConfiguration

connectTimeout string

Format duration

The time allowed to establish a connection to the server before failing.

readIdleTimeout string

Default PT5M

Format duration

The time allowed for a read connection to remain idle before closing it.

io.kestra.core.http.client.configurations.BasicAuthConfiguration

type *object

password string

The password for HTTP basic authentication.

username string

The username for HTTP basic authentication.

java.nio.charset.Charset

io.kestra.core.http.client.configurations.HttpConfiguration

allowFailed booleanstring

Default false

If true, allow a failed response code (response code >= 400)

allowedResponseCodes array

SubType integer

List of response code allowed for this request

auth BasicAuthConfiguration BearerAuthConfiguration

The authentification to use.

defaultCharset Charsetstring

Default UTF-8

The default charset for the request.

followRedirects booleanstring

Default true

Whether redirects should be followed automatically.

logs array

SubType string

Possible Values

REQUEST_HEADERSREQUEST_BODYRESPONSE_HEADERSRESPONSE_BODY

The enabled log.

proxy ProxyConfiguration

The proxy configuration.

ssl SslOptions

The SSL request options

timeout TimeoutConfiguration

The timeout configuration.

io.kestra.core.http.client.configurations.ProxyConfiguration

address string

The address of the proxy server.

password string

The password for proxy authentication.

port integerstring

The port of the proxy server.

type string

Default DIRECT

Possible Values

DIRECTHTTPSOCKS

The type of proxy to use.

username string

The username for proxy authentication.

io.kestra.core.http.client.configurations.SslOptions

insecureTrustAllCertificates booleanstring

Whether to disable checking of the remote SSL certificate.

Only applies if no trust store is configured. Note: This makes the SSL connection insecure and should only be used for testing. If you are using a self-signed certificate, set up a trust store instead.

io.kestra.core.http.client.configurations.BearerAuthConfiguration

type *object

token string

The token for bearer token authentication.

​Create

Create