skills.rest
shalevamin
shalevaminCOMMUNITY
Explore all skills by this author →
GitHub

notion

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

Updated Mar 7, 2026
Search Tags:#automation#database#api#workspace#notion#curl#pages
One-click install
npx skills add https://github.com/shalevamin/Tau_agent --skill notion-shalevamin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/shalevamin/Tau_agent/tree/main/tau-agent-main/skills/notion
Command: npx skills add https://github.com/shalevamin/Tau_agent --skill notion-shalevamin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Notion workspaces programmatically requires learning the Notion API's authentication, versioning headers, and property formats, which slows down automation of page and database operations. ## Core Features & Use Cases - Page and Block Management: Create, read, and update pages and append content blocks such as paragraphs to existing pages. - Database Operations: Query data sources with filters and sorts, and create new databases with typed properties like select, date, and relation. - Use Case: Imagine you want to log daily standup notes into a Notion database automatically. Use this Skill to query the database, create a new page with the date and status properties, and append summary blocks. ## Quick Start Use the notion skill to create a new page in my tasks database with the title "Weekly Report" and status set to Todo.

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 typed values like title, select, or date. Include the Authorization bearer token and Notion-Version header.

How to 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 as data sources using their data_source_id.

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

In Notion-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 database via /v1/data_sources/ endpoints.

Does the Notion API require an integration token?▼

Yes, you must create an integration at notion.so/my-integrations to get an API key starting with ntn_ or secret_. You must also share target pages or databases with the integration before the API can access them.

What are the Notion API rate limits and payload limits?▼

The API allows roughly 3 requests per second and returns 429 rate_limited responses with a Retry-After header. Appending blocks supports up to 100 children per request, with payloads capped at 1000 block elements and 500KB.

Related Skills

Explore More Product & Management Skills→
harlanljonesharlanljones

notion

Manage Notion pages, databases, and Workers via the ntn CLI or HTTP API.

Community
Advanced
vctplatformvctplatform

data-engineer

Design and implement data pipelines and reporting for the VCT Platform.

Community
Advanced
syl2042syl2042

notion-meeting-intelligence

Generate Notion meeting agendas with Codex-enriched pre-reads and linked source materials.

Community
Advanced
MOODMNKY-LLCMOODMNKY-LLC

notion

Automate Notion workspace management via CLI and REST API.

Community
Intermediate