skills.rest
Cyandex
CyandexCOMMUNITY
Explore all skills by this author →
GitHub

notion

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Notion workspaces programmatically requires navigating the Notion REST API's authentication, versioning headers, and property schemas, which is tedious to do by hand. This Skill provides ready-to-use curl commands and property format references so you can create pages, query databases, and update content without reading the full API documentation. ## Core Features & Use Cases - Page and Block Management: Create pages, append paragraph blocks, and update page properties like status or dates. - Data Source Operations: Query databases with filters and sorts, and create new data sources with custom property schemas. - Search and Retrieval: Search across pages and data sources, and fetch page content as block children. - Use Case: Imagine you want to log completed tasks into a Notion database automatically. Use this Skill to query the data source for the right database ID, then create a new page with title, status, and date properties in one request. ## Quick Start Use the notion skill to create a new page titled "Weekly Report" in my tasks database with the 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 set to your database_id and a properties object containing fields like title, select, and date. Include the Authorization bearer token and Notion-Version header in the request.

How do I query a Notion database with filters?▼

POST to /v1/data_sources/{data_source_id}/query with a JSON body containing filter and sorts objects. In API version 2025-09-03, databases are called data sources, so use the data_source_id rather than the database_id for queries.

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

In Notion API version 2025-09-03, each database has both IDs. Use database_id when creating pages as the parent, and data_source_id when querying or retrieving the database. Search results return databases as data_source objects with their data_source_id.

Why does my Notion API request return an unauthorized error?▼

Unauthorized errors usually mean the integration lacks access to the target page or database. Open the page in Notion, click the "..." menu, choose "Connect to", and select your integration. Also verify your API 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. For bulk operations, add delays between requests or implement retry logic to stay within the limit.

Related Skills

Explore More Product & Management Skills→
Merit-SystemsMerit-Systems
3

web-research

Perform neural searches and extract clean text from x402-protected web endpoints.

Official
Intermediate
benjaminkittbenjaminkitt

openspec-archive-change

Archive completed changes with artifact validation and delta-spec synchronization.

Community
Advanced
CoachSteffCoachSteff
1

marketer

Automate content scheduling and publishing across LinkedIn, Twitter, and Instagram via Notion and n8n.

Community
Advanced
OpenMinisOpenMinis
361

notion-hub

Perform Notion read/write operations via Python CLI using notion-client SDK.

Official
Intermediate