skills.rest
zhoulingxiao1216
zhoulingxiao1216COMMUNITY
Explore all skills by this author →
GitHub

notion

Manage Notion pages, databases, and blocks via the Notion API using curl.

Updated Jun 30, 2026
Search Tags:#productivity#database#api#notion#blocks#curl#pages
One-click install
npx skills add https://github.com/zhoulingxiao1216/testworkspace --skill notion-zhoulingxiao1216
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/zhoulingxiao1216/testworkspace/tree/main/all_Skills/productivity/notion
Command: npx skills add https://github.com/zhoulingxiao1216/testworkspace --skill notion-zhoulingxiao1216

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Working with Notion programmatically often requires learning SDKs or writing boilerplate code. This Skill lets you interact with the Notion API directly through curl commands to search, read, create, and update pages, databases, and blocks without extra tooling. ## Core Features & Use Cases - Full CRUD via curl: Search workspaces, get page content, create pages in databases, query data sources with filters and sorts, and update page properties. - Block-level content management: Append paragraphs, headings, lists, to-dos, code blocks, callouts, and more to any page, with a complete block-type reference. - API version 2025-09-03 guidance: Covers the data sources model, including the distinction between database_id and data_source_id. - Use Case: Ask the assistant to create a new task in your Notion project database with a status and due date, then append meeting notes as blocks to an existing page. ## Quick Start Set your NOTION_API_KEY environment variable and ask the assistant to create a new page in your Notion database with a title and status.

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 database_id and a properties object containing title, select, date, or other property values. Include the Authorization bearer token and Notion-Version header.

How do I query a Notion database with filters?▼

In API version 2025-09-03, POST to /v1/data_sources/{data_source_id}/query with a filter object, such as a select property equals condition, plus optional sorts. Note that querying uses the data_source_id, not the database_id.

What is the difference between database_id and data_source_id in Notion?▼

Each Notion database has both IDs in API version 2025-09-03. Use database_id as the parent when creating pages, and data_source_id when querying the database's rows via the /v1/data_sources endpoint.

Why does the Notion API return an error when accessing my page?▼

The most common cause is that the page or database was not shared with your integration. In Notion, open the page, click the menu, choose Connect to, and select your integration name.

What are the rate limits of the Notion API?▼

The Notion API allows roughly 3 requests per second on average. For bulk operations, pace your curl calls and consider batching block children in a single PATCH request.

Related Skills

Explore More Product & Management Skills→
taracodlabstaracodlabs
799

notion

Read, create, and update Notion pages and databases via the Notion REST API.

Official
Intermediate
adoreseveradoresever
202

notion

Manage Notion pages, databases, and blocks via the Notion API.

Community
Intermediate
llmh333llmh333

data-scraper-agent

Automate scheduled collection, AI enrichment, and deduplicated storage of public data.

Community
Advanced
vercel-labsvercel-labs
66

claude-api

Build, debug, and optimize Claude API applications with Anthropic SDK bindings.

Official
Advanced