Read a Notion page

Retrieves an existing Notion page by ID and returns its content in markdown format along with metadata.

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

Read a page by ID

yaml
id: notion_read_page
namespace: company.team

inputs:
  - id: page_id
    type: STRING

tasks:
  - id: read_page
    type: io.kestra.plugin.notion.page.Read
    apiToken: "{{ secret('NOTION_API_TOKEN') }}"
    pageId: "{{ inputs.page_id }}"

Read a specific page

yaml
id: notion_read_specific_page
namespace: company.team

tasks:
  - id: read_meeting_notes
    type: io.kestra.plugin.notion.page.Read
    apiToken: "{{ secret('NOTION_API_TOKEN') }}"
    pageId: "12345678-1234-1234-1234-123456789abc"
Properties

Page ID

The unique identifier of the Notion page

Notion API token

The Notion API integration token (Internal Secret connection)

The HTTP client configuration.

Archived

Whether the page is archived

Content

The page content in markdown format

Format date-time

Created Time

When the page was created

Format date-time

Last Edited Time

When the page was last edited

Message

Operation result message

Page ID

The unique identifier of the page

Properties

Additional page properties

Page Title

The title of the page

Page URL

The URL of the page in Notion

Format duration

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

Default PT5M
Format duration

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

The password for HTTP basic authentication.

The username for HTTP basic authentication.

Default false

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

SubType integer

List of response code allowed for this request

The authentification to use.

Default UTF-8

The default charset for the request.

Default true

Whether redirects should be followed automatically.

SubType string
Possible Values
REQUEST_HEADERSREQUEST_BODYRESPONSE_HEADERSRESPONSE_BODY

The enabled log.

The proxy configuration.

The SSL request options

The timeout configuration.

The address of the proxy server.

The password for proxy authentication.

The port of the proxy server.

Default DIRECT
Possible Values
DIRECTHTTPSOCKS

The type of proxy to use.

The username for proxy authentication.

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.

The token for bearer token authentication.