skills.rest
yakeworld
yakeworldCOMMUNITY
Explore all skills by this author →
GitHub

notion

Manage Notion pages, databases, and blocks via curl API calls.

6|1|Updated May 11, 2026
Search Tags:#automation#productivity#database#api#notion#notes#curl
One-click install
npx skills add https://github.com/yakeworld/Synthos --skill notion-yakeworld
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/yakeworld/Synthos/tree/main/skills/extended/external-automation/automation-skills/productivity/notion
Command: npx skills add https://github.com/yakeworld/Synthos --skill notion-yakeworld

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Working with Notion programmatically requires handling API versioning, dual database/data source IDs, and strict property JSON schemas, which is error-prone when done by hand. This Skill provides ready-to-use curl patterns for the Notion API (version 2025-09-03) so you can create, read, update, and query pages, databases, and blocks without writing boilerplate. ## Core Features & Use Cases - Full CRUD via curl: Search, get pages, read block children, create pages in databases, query data sources with filters and sorts, create databases, update properties, and append content blocks. - API version 2025-09-03 guidance: Correctly distinguishes database_id (for creating pages) from data_source_id (for querying), and uses the new /data_sources/ endpoints. - Property and block type references: Covers title, rich text, select, multi-select, date, checkbox, number, URL, email, and relation property formats, plus a complete block-type reference for paragraphs, headings, lists, to-dos, code, callouts, and more. - Use Case: Ask the agent to add a new task to your Notion project database with a status and due date, then append a summary paragraph to the created page. ## Quick Start Use the notion skill to create a new page titled "Weekly Report" in my Notion database with 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 {"database_id": "..."} and properties following the type schemas, such as {"title": [{"text": {"content": "..."}}]} for titles. Include the Authorization Bearer token and Notion-Version: 2025-09-03 headers.

How do I query a Notion database with filters?▼

In API version 2025-09-03, query via POST /v1/data_sources/{data_source_id}/query with a filter object like {"property": "Status", "select": {"equals": "Active"}} and an optional sorts array. Note that databases are now called data sources in this version.

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

Each database has both IDs in version 2025-09-03. Use database_id as the parent when creating pages, and data_source_id when querying via the /v1/data_sources/{id}/query endpoint. Mixing them up causes request failures.

Why does the Notion API return 404 object_not_found?▼

A 404 object_not_found usually means the target page or database has not been shared with your integration. Open the page in Notion, click "..." then "Connect to", select your integration, and retry the request once.

What are the Notion API rate limits and requirements?▼

The API allows roughly 3 requests per second on average. Every request must include the Notion-Version: 2025-09-03 header and a Bearer token from an integration created at notion.so/my-integrations, stored as NOTION_API_KEY.

Related Skills

Explore More Product & Management Skills→
AlexiosBluffMaraAlexiosBluffMara
2

notion

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

Community
Intermediate
BEIRUXBEIRUX

notion

Automate Notion workspace management via the Notion API for pages, databases, and blocks.

Official
Intermediate
MoCapOnlineMoCapOnline

mco-sync-monitor

Monitor and validate Airtable to Shopify data synchronization for MoCap Online.

Community
Advanced
dennisvinkdennisvink

aws-sdk-python-usage

Write Python code using boto3 and botocore for AWS service operations.

Community
Advanced