Notion logo

Notion

Search pages, manage databases, create and update content, and read blocks in your Notion workspace.

Authentication

Supported Authentication Methods

Drop in currently supports:

  • Internal Integration Token (API Key)

Notion also offers Public OAuth integration, which is coming soon to Drop in.

Using Internal Integration Token

To connect Notion with Drop in, you'll need to create an internal integration and share your pages with it:

  1. Go to My Integrations and click New integration
  2. Give your integration a name (e.g., "Drop in Integration")
  3. Select the workspace you want to connect
  4. Under Capabilities, ensure the following are enabled:
    • Read content - Required for retrieving pages, databases, and blocks
    • Update content - Required for updating pages and databases
    • Insert content - Required for creating pages and appending blocks
  5. Click Save to create the integration
  6. Copy your Internal Integration Secret (starts with ntn_)
  7. Important: Open the Notion pages or databases you want Drop in to access, click the ... menu in the top right, select Connections, and add your integration
  8. In Drop in, select Notion when creating a drop and paste your integration token

Important: Your integration can only access pages and databases that have been explicitly shared with it. If a page is not shared with the integration, API calls will return a "not found" error even if the page exists.

Resources:

Using OAuth

OAuth authentication allows Drop in to access your Notion workspace without storing your credentials.

To set up OAuth, you'll need to create a public integration in the Notion developer portal. Visit the OAuth documentation to learn more.

This option is coming soon to Drop in.

Providing Context

Many Notion actions require identifiers like a page ID, database ID, or block ID so the AI knows which content to work with. You don't need to memorize these — the AI can look them up, or you can find them yourself.

How IDs Work in Notion

Notion uses UUIDs (long strings like aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee) to identify everything: pages, databases, data sources, and blocks. Here's how to find them:

  • Page ID — Found by asking the AI to search your pages, or from the Notion URL. When you open a page, the ID is the 32-character string at the end of the URL.
  • Database / Data Source ID — Found by asking the AI to search your data sources, or from the URL when you open a database in Notion.
  • Block ID — Found by asking the AI to get the block children of a page. Every paragraph, heading, to-do item, and other content element is a block with its own ID.

Letting the AI Find IDs for You

When you describe what you want in plain language (e.g., "add a page to my Tasks database" or "find my meeting notes"), the AI will automatically search your workspace, find the right database or page, and then perform the action. You only need to provide IDs yourself if you want to target a specific resource directly.

Finding IDs from the Notion URL

When you open a page or database in the browser, the URL contains the ID:

notion.so/Your-Page-Title-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

The last 32 characters (after the final dash) are the page or database ID. You can mention this in your prompt if you prefer.

Sharing Pages with Your Integration

Remember that your Notion integration can only access pages and databases that have been explicitly shared with it. If the AI cannot find a page you expect, open it in Notion, click ... > Connections, and add your integration.

Available Actions

Search Pages

Search for pages across your Notion workspace and return matching results with page IDs.

Search Data Sources

Search for Notion data sources (databases) in your workspace and return matching results with their IDs.

Retrieve Database

Retrieve a Notion database by ID to inspect its schema, properties, and structure.

Update Database

Update a database's title, description, icon, or cover image.

Retrieve Data Source

Retrieve a Notion data source by ID to view its configuration and metadata.

Query Data Source

Query a Notion data source to list pages with filters, sorting, and pagination.

Retrieve Page

Retrieve a Notion page by ID to read its properties and metadata.

Create Page

Create a new page in a database or under a parent page, with properties and optional content blocks.

Update Page

Update properties or archive status on an existing Notion page.

Retrieve Block

Retrieve a single content block by ID to inspect its type and content.

Get Block Children

List all child blocks of a page or block, with pagination support.

Append Block Children

Add new content blocks to a page or existing block, such as paragraphs, headings, to-do items, and more.

Common Issues

Page Not Found Errors

If you receive "object not found" errors when accessing a page or database:

  • Ensure the page or database has been shared with your integration via the Connections menu
  • Verify the page ID is correct (you can find it in the page URL after the workspace name)
  • Check that your integration has the required capabilities enabled

Authentication Failed

If you receive authentication errors:

  • Verify your integration token is correct and starts with ntn_
  • Check that the integration has not been deleted or disabled
  • Ensure you are using the token from the correct workspace

Rate Limits

Notion enforces a rate limit of 3 requests per second per integration. If you see rate limit errors:

  • Space out requests when performing bulk operations
  • Use search and query operations with filters to reduce the number of calls needed
  • Avoid requesting the same data repeatedly in a short time

Block Content Formatting

If appended blocks do not display as expected:

  • Ensure you are using the correct block type for your content (paragraph, heading, to_do, etc.)
  • Rich text content requires a specific structure with text objects
  • Nested blocks may need to be appended as children of an existing block

Need help? Contact support