skills.rest
AvaTar-ArTs
AvaTar-ArTsCOMMUNITY
Explore all skills by this author →
GitHub

notion

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

Updated Jul 10, 2026
Search Tags:#productivity#database#api#notion#notes#curl#pages
One-click install
npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill notion-avatar-arts
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/AvaTar-ArTs/.Agent-skills/tree/main/skills/productivity/notion
Command: npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill notion-avatar-arts

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Working with Notion programmatically requires learning the API's endpoints, authentication headers, version-specific quirks, and JSON property formats. This Skill provides ready-to-use curl commands for every common Notion API operation, so you can create, read, update, and query Notion content directly from the command line without writing integration code. ## Core Features & Use Cases - Full CRUD Operations: Search, create, read, and update pages, databases (data sources), and blocks using the Notion API version 2025-09-03. - Database Querying: Query data sources with filters and sorts, and create new databases with typed properties like select, date, and relation. - Block Reference: A detailed reference of all block types (headings, lists, to-dos, code, callouts, toggles) with JSON payloads for creating and reading them. - Use Case: Imagine you want to log daily standup notes into a Notion database automatically. Use this Skill to query the database for today's entry, create a new page if none exists, and append formatted blocks with your notes. ## Quick Start Use the notion skill to create a new page in my Notion database with the title "Weekly Report" and a Status of "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 in every request.

How to query a Notion database with filters using curl?▼

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 queried as data sources, so use the data_source_id rather than the database_id.

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

In Notion API version 2025-09-03, each database has both a database_id and a data_source_id. Use database_id when creating pages as the parent, and data_source_id when querying the database contents.

Why does the Notion API return an error for my integration?▼

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

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 accordingly and consider adding delays between requests to avoid throttling.

Related Skills

Explore More Product & Management Skills→
AlexiosBluffMaraAlexiosBluffMara
2

notion

Manageesponds Notion pages, databases and blocks via curl with the official API.

Community
Intermediate
wuv-dreamguidewuv-dreamguide

notion

Automate Notion page, database, and block management via API.

Official
Intermediate
bibo1243bibo1243

4D Workflow Backend Architecture & Sync

Orchestrate bidirectional Notion and Google Calendar synchronization via a REST API.

Community
Advanced
ramshan00ramshan00

mcp-sdk

Implement MCP servers and clients in Python with tools, resources, and prompts.

Community
Intermediate