Notion Connector

Connect Zenmako to Notion to manage pages, databases, and workspace content. This enables AI to search your workspace, read and update pages, query databases, and add comments to collaborate with your team.

Getting Your Integration Token

Notion uses Internal Integrations for API authentication. Follow these steps to create one:

  • Go to https://www.notion.so/my-integrations
  • Click New integration
  • Give your integration a name (e.g., "Zenmako Integration")
  • Select the workspace you want to connect
  • Click Submit
  • Copy the Internal Integration Token (starts with secret_)

    • Sharing Pages with Your Integration

    Your integration can only access pages that have been explicitly shared with it:

  • Open the Notion page or database you want to access
  • Click the ... menu in the top right corner
  • Click Add connections
  • Search for and select your integration name
  • Click Confirm

    • Repeat this for each page or database you want Zenmako to access. Child pages inherit access from their parent, so sharing a parent page gives access to all its subpages.

    Connecting Notion

  • Navigate to the Connections page in Zenmako
  • Click Add Connection and select Notion
  • Enter your credentials:
    • - API Token: Paste the Internal Integration Token you generated
  • Click Save
  • Click Test Connection to verify the setup works

    • If the test succeeds, your Notion connection is ready to use.

    Available Actions

    ActionDescription
    searchFind pages and databases by keyword
    retrievePageRead a wiki page or doc by ID
    createPageCreate meeting notes, documentation, or new pages
    updatePageUpdate status or add info to pages
    queryDatabaseLook up entries in a tracker or CRM database
    retrieveDatabaseUnderstand what fields exist in a database
    retrieveBlockChildrenRead page content (blocks inside a page)
    appendBlockChildrenAdd content to a page
    updateBlockEdit existing content blocks
    listUsersSee who is in the workspace
    createCommentLeave feedback on pages
    listCommentsSee discussion on a page

    Example Prompts

    Try these prompts to interact with your Notion data:

  • "Search for pages about Q4 planning in Notion"
  • "Show me all entries in my Tasks database"
  • "Create a new meeting notes page for today's standup"
  • "What fields are available in my Project Tracker database?"
  • "Add a comment to the Product Roadmap page asking for feedback on the new feature"

    • Common Issues

    "Object not found" or "Could not find page" error

    This typically means the page has not been shared with your integration. Solutions:

  • Open the page in Notion and verify your integration is listed under Connections
  • Add the integration to the page via the ... menu and Add connections
  • If accessing a child page, ensure the parent page is shared with the integration

    • Cannot access a database

    Databases must be explicitly shared with your integration, even if they appear within a shared page. Solutions:

  • Open the database in full-page view
  • Click the ... menu and select Add connections
  • Add your integration and confirm