Loading

Notion connector

Serverless Preview Stack Preview

The Notion connector communicates with the Notion API to explore content and databases in your Notion workspace.

You can create connectors in Stack Management > Connectors. For example:

Notion connectors have the following configuration properties:

API Token
The Notion API token (bearer token) for authentication.

You can test connectors as you're creating or editing the connector in Kibana.

The Notion connector has the following actions:

Search Page or Data Source by Title

Search for pages or databases by title.

  • Query (required): The search query string.
  • Query Object Type (required): Type of object to search for (page or data_source).
  • Start Cursor (optional): Cursor for pagination.
  • Page Size (optional): Number of results per page.
Get Page

Retrieve a page by its ID.

  • Page ID (required): The unique identifier of the page.
Get Data Source

Retrieve a database by its ID.

  • Data Source ID (required): The unique identifier of the database.
Query Data Source

Query a database with optional filters.

  • Data Source ID (required): The unique identifier of the database to query.
  • Filter (optional): JSON string representing the filter object.
  • Start Cursor (optional): Cursor for pagination.
  • Page Size (optional): Number of results per page.

Use the Action configuration settings to customize connector networking configurations, such as proxies, certificates, or TLS settings. You can set configurations that apply to all your connectors or use xpack.actions.customHostSettings to set per-host configurations.

To use the Notion connector, you need to create an internal integration:

  1. Go to Notion.
  2. Navigate to My integrations.
  3. Click + New integration.
  4. Configure your integration:
    • Set a name for your integration.
    • Select the workspace where you want to use the integration.
    • Configure the capabilities (content, comment, and user capabilities as needed).
  5. Click Submit to create the integration.
  6. Copy the Internal Integration Token (this is your bearer token).
  7. Share the pages and databases you want to access with your integration by clicking Share on the page or database and inviting your integration.