skills.rest
jamsdoescode
jamsdoescodeCOMMUNITY
Explore all skills by this author →
GitHub

notion

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

Updated Jul 7, 2026
Search Tags:#automation#productivity#database#api#notion#curl#pages
One-click install
npx skills add https://github.com/jamsdoescode/Erik-s-Portfolio --skill notion-jamsdoescode
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/jamsdoescode/Erik-s-Portfolio/tree/main/openclicky/AppResources/OpenClicky/OpenClickyBundledSkills/notion
Command: npx skills add https://github.com/jamsdoescode/Erik-s-Portfolio --skill notion-jamsdoescode

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working with Notion programmatically requires learning its REST API structure, authentication headers, and version-specific endpoints. This Skill provides ready-to-use curl commands for every common Notion operation, so you can create pages, query databases, and update content without reading API documentation. ## Core Features & Use Cases - Page & Block Operations: Create, read, and update pages, and append content blocks like paragraphs to any page. - Database Management: Query data sources with filters and sorts, create new databases with typed properties, and insert rows. - Search: Find pages and databases across your workspace by title. - Use Case: Ask the assistant to add a new task with status "Todo" to your Notion project tracker database, and it runs the correct authenticated curl request with properly formatted property payloads. ## Quick Start Set your NOTION_API_KEY environment variable, share your target pages with your Notion integration, then ask the assistant to create a new page in your Notion database.

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 matching the database schema. 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.

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

Most errors occur because the target 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 before calling the API.

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

In API version 2025-09-03, each database has both IDs. Use database_id when creating pages as a parent, and data_source_id when querying database contents through the /v1/data_sources endpoints.

What are the rate limits of the Notion API?▼

The Notion API allows roughly 3 requests per second on average. Batch operations where possible and add delays between sequential curl calls to avoid throttling errors.

Related Skills

Explore More Product & Management Skills→
clsdavidclsdavid

notion

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

Community
Intermediate
BEIRUXBEIRUX

notion

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

Official
Intermediate
Wakewell-Sleep-SolutionsWakewell-Sleep-Solutions

n8n-workflows

Automate dental practice workflows with n8n across SMS, email, and calendar events.

Official
Advanced
awsaws
2.5k

aws-sdk-python-usage

Guides writing Python code with boto3 and botocore for AWS services.

Official
Advanced