notion

Create, query, and update Notion pages, databases, and blocks via the Notion API.

1|Updated Aug 5, 2026
One-click install
npx skills add https://github.com/Solizardking/Solana-Robotics-Kit --skill notion-solizardking
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/Solizardking/Solana-Robotics-Kit/tree/main/eliza/packages/skills/skills/notion
Command: npx skills add https://github.com/Solizardking/Solana-Robotics-Kit --skill notion-solizardking

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Notion workspaces programmatically requires handling API authentication, versioned headers, and the distinction between database IDs and data source IDs, which is error-prone when done manually. ## Core Features & Use Cases - Page and Block Management: Create pages, retrieve page content, and append blocks such as paragraphs to existing pages. - Data Source Operations: Query databases with filters and sorts, and create new data sources with typed properties like select, date, and relation. - Property Updates: Update page properties including status, dates, multi-selects, and relations using the 2025-09-03 API version. - Use Case: A user wants to log completed tasks into a Notion database; the skill searches for the data source, creates a page with the correct property schema, and updates its status. ## Quick Start Ask the assistant to create a new page in your Notion database with a title and status property using your stored Notion API key.

Frequently Asked Questions about notion

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a page in a Notion database with the API?

Send a POST request to https://api.notion.com/v1/pages with the parent set to your database_id and a properties object matching the database schema. Include the Authorization bearer token and Notion-Version header in every request.

How do I query a Notion database with filters?

POST to /v1/data_sources/{data_source_id}/query with a filter object, such as a select property equals condition, plus optional sorts. In API version 2025-09-03, databases are queried through data source endpoints rather than the old database query endpoint.

What is the difference between database_id and data_source_id in Notion?

In API version 2025-09-03, each database has both IDs. Use database_id as the parent when creating pages, and data_source_id when querying or retrieving the data source. Search results return the data_source_id directly.

Why does my Notion API request fail with authentication errors?

Requests fail when the API key is missing, malformed, or the integration has not been shared with the target page or database. Share the page via the 'Connect to' option in Notion and verify the key starts with ntn_ or secret_.

What are the rate limits of the Notion API?

The Notion API allows roughly 3 requests per second on average. Batch operations where possible and add retry logic with backoff when automating bulk page creation or updates.