Notion

Notion is a new tool that blends your everyday work apps into one. It's the all-in-one workspace for you and your team.

Go to site
Explore
/
Apps
/
Notion

Notion API Integrations

Build and run workflows using the Notion API. Use 1000s of source-available triggers and actions across 2,200+ apps. Or write custom code to integrate any app or API in seconds.

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Adyen logo
Appcues logo
Bandwidth logo
Checkr logo
ChartMogul logo
Dataminr logo
Gopuff logo
Gorgias logo
LinkedIn logo
Logitech logo
Replicated logo
Rudderstack logo
SAS logo
Scale AI logo
Webflow logo
Warner Bros. logo
Adyen logo
Appcues logo
Bandwidth logo
Checkr logo
ChartMogul logo
Dataminr logo
Gopuff logo
Gorgias logo
LinkedIn logo
Logitech logo
Replicated logo
Rudderstack logo
SAS logo
Scale AI logo
Webflow logo
Warner Bros. logo

Overview

Notion's API allows for the creation, reading, updating, and deleting of pages, databases, and their contents within Notion. Using Pipedream's platform, you can build workflows that connect Notion with various other services to automate tasks such as content management, task tracking, and data synchronization. With Pipedream's serverless execution, you can trigger these workflows on a schedule, or by external events from other services, without managing any infrastructure.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
import { axios } from "@pipedream/platform"
export default defineComponent({
  props: {
    notion: {
      type: "app",
      app: "notion",
    }
  },
  async run({steps, $}) {
    return await axios($, {
      url: `https://api.notion.com/v1/users/me`,
      headers: {
        Authorization: `Bearer ${this.notion.$auth.oauth_access_token}`,
        "Notion-Version": `2021-08-16`,
      },
    })
  },
})

Choose an API to Connect with Notion API

1
-
24
of
2,200+
apps by most popular

HTTP / Webhook
HTTP / Webhook
Get a unique URL where you can send HTTP or webhook requests
Node
Node
Anything you can do with Node.js, you can do in a Pipedream workflow. This includes using most of npm's 400,000+ packages.
Python
Python
Anything you can do in Python can be done in a Pipedream Workflow. This includes using any of the 350,000+ PyPi packages available in your Python powered workflows.
OpenAI (ChatGPT)
OpenAI (ChatGPT)
OpenAI is an AI research and deployment company with the mission to ensure that artificial general intelligence benefits all of humanity. They are the makers of popular models like ChatGPT, DALL-E, and Whisper.
Premium
Salesforce
Salesforce
Web services API for interacting with Salesforce
Premium
HubSpot
HubSpot
HubSpot's CRM platform contains the marketing, sales, service, operations, and website-building software you need to grow your business.
Premium
Zoho CRM
Zoho CRM
Zoho CRM is an online Sales CRM software that manages your sales, marketing, and support in one CRM platform.
Premium
Stripe
Stripe
Stripe powers online and in-person payment processing and financial solutions for businesses of all sizes.
Shopify
Shopify
Shopify is a complete commerce platform that lets anyone start, manage, and grow a business. You can use Shopify to build an online store, manage sales, market to customers, and accept payments in digital and physical locations.
Premium
WooCommerce
WooCommerce
WooCommerce is the open-source ecommerce platform for WordPress.
Premium
Snowflake
Snowflake
A data warehouse built for the cloud
Premium
MongoDB
MongoDB
MongoDB is an open source NoSQL database management program.
Supabase
Supabase
Supabase is an open source Firebase alternative.
MySQL
MySQL
MySQL is an open-source relational database management system.
PostgreSQL
PostgreSQL
PostgreSQL is a free and open-source relational database management system emphasizing extensibility and SQL compliance.
Premium
AWS
AWS
Amazon Web Services (AWS) offers reliable, scalable, and inexpensive cloud computing services.
Premium
Twilio SendGrid
Twilio SendGrid
Send marketing and transactional email through the Twilio SendGrid platform with the Email API, proprietary mail transfer agent, and infrastructure for scalable delivery.
Amazon SES
Amazon SES
Amazon SES is a cloud-based email service provider that can integrate into any application for high volume email automation
Premium
Klaviyo
Klaviyo
Email Marketing and SMS Marketing Platform
Premium
Zendesk
Zendesk
Zendesk is award-winning customer service software trusted by 200K+ customers. Make customers happy via text, mobile, phone, email, live chat, social media.
Notion
Notion
Notion is a new tool that blends your everyday work apps into one. It's the all-in-one workspace for you and your team.
Slack
Slack
Slack is a channel-based messaging platform. With Slack, people can work together more effectively, connect all their software tools and services, and find the information they need to do their best work — all within a secure, enterprise-grade environment.
Microsoft Teams
Microsoft Teams
Microsoft Teams has communities, events, chats, channels, meetings, storage, tasks, and calendars in one place.
Schedule
Schedule
Trigger workflows on an interval or cron schedule.

Example Use Cases

  • Content Sync Between Notion and a CMS: Automatically push new blog posts from Notion to WordPress, ensuring a seamless content flow from drafting to publishing.

  • Task Management with Todoist Integration: When a new task is added to a Notion database, create a corresponding task in Todoist, and vice versa, keeping task lists synced across platforms.

  • Daily Sales Report Generation: Gather sales data from a tool like Shopify at the end of each day, sum up total sales, and create a page in Notion with the day's sales summary for easy reporting.

Getting Started

To get started, first log in to or create your Pipedream account and start a new workflow.

Add a Notion action or trigger to your workflow, then click Select a Notion account to open a Notion connection window:

Selecting your Notion API account

From within this window, select pages you'd like Pipedream to access:

Select the Notion pages that you'd like Pipedream to have access to

Click Accept to connect your Notion account to Pipedream.

Append Block to Parent with Notion API on New Commit (Instant) from BitBucket API
BitBucket + Notion
 
Try it
Create a Page with Notion API on New Gist from GitHub API
GitHub + Notion
 
Try it
Create a Page with Notion API on New or Modified Files from Google Drive API
Google Drive + Notion
 
Try it
Get Full Details of UUID with Confection API on New Database from Notion API
Notion + Confection
 
Try it
Get Backlinks with Ahrefs API on New Page from Notion API
Notion + Ahrefs
 
Try it
New Database from the Notion API

Emit new event when a database is created. Note: Databases must be shared with your Pipedream Integtration to trigger event.

 
Try it
New Page in Database from the Notion API

Emit new event when a page in a database is created

 
Try it
Page or Subpage Updated from the Notion API

Emit new event when a page or one of its sub-pages is updated.

 
Try it
Updated Page ID from the Notion API

Emit new event when a selected page is updated

 
Try it
Updated Page in Database from the Notion API

Emit new event when a page in a database is updated. To select a specific page, use Updated Page ID instead

 
Try it
Append Block to Parent with the Notion API

Creates and appends blocks to the specified parent. See the documentation

 
Try it
Create Page with the Notion API

Creates a page from a parent page. The only valid property is title. See the documentation

 
Try it
Create Page from Database with the Notion API

Creates a page from a database. See the docs

 
Try it
Duplicate Page with the Notion API

Creates a new page copied from an existing page block. See the docs

 
Try it
Find a Page with the Notion API

Searches for a page by its title. See the docs

 
Try it

Troubleshooting

Unable to find a new database

After creating a new database, reconnect your account and select it to enable Pipedream access.

HTTP errors

400 "invalid_json"

Ensure the request body is formatted as valid JSON.

400 "invalid_request_url"

The URL in your request is incorrect. Ensure the correct format and parameters.

400 "invalid_request"

The request type isn't supported. Ensure the correct format and parameters.

400 "invalid_grant"

Your authorization grant or refresh token is invalid, expired, or mismatched. Refer to OAuth 2.0 documentation.

400 "validation_error"

The request body doesn't match the expected parameters schema. You're most likely missing a key parameter, or a parameter is malformed.

400 "missing_version"

If your request lacks the required Notion-Version header, try adding a new Notion step in Pipedream, as it should handle this automatically.

401 "unauthorized"

If your API token is invalid, reconnect your Notion account to Pipedream.

403 "restricted_resource"

Your API token doesn't have permission to perform this operation. Try reconnecting your Notion account to Pipedream.

404 "object_not_found"

The requested resource doesn't exist or isn't shared with your API token. Double check that the block, database or page exists.

409 "conflict_error"

A conflict occurred, possibly due to outdated parameters. Try updating your parameters.

429 "rate_limited"

You've exceeded the number of allowed requests. Slow down your request rate.

500 "internal_server_error"

An unexpected error has occurred. Contact Notion support if it persists.

502 "bad_gateway"

Notion had a problem processing your request, possibly due to an upstream server issue.

503 "service_unavailable"

Notion is temporarily unavailable, possibly due to a long response time. Try again later.

503 "database_connection_unavailable"

Notion's database cannot be queried at the moment. Try again later.

504 "gateway_timeout"

Your request to Notion timed out. Try resending it after a while.

Authentication

Name Slug: notion

Notion uses OAuth authentication. When you connect your Notion account, Pipedream will open a popup window where you can sign into Notion and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any Notion API.

Pipedream requests the following authorization scopes when you connect your account:

OAuth Request Configurations:
  1. authorization
    GEThttps://api.notion.com/v1/oauth/authorize?client_id={{oauth.client_id}}&redirect_uri={{oauth.redirect_uri}}&state={{oauth.state}}&response_type=code&scope={{oauth.space_separated_scopes}}&owner=user
  2. accessToken
    POSThttps://api.notion.com/v1/oauth/tokencontent-type: application/x-www-form-urlencodedaccept: application/json
    redirect_uri={{oauth.redirect_uri}}&grant_type=authorization_code&code={{oauth.code}}

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Adyen logo
Appcues logo
Bandwidth logo
Checkr logo
ChartMogul logo
Dataminr logo
Gopuff logo
Gorgias logo
LinkedIn logo
Logitech logo
Replicated logo
Rudderstack logo
SAS logo
Scale AI logo
Webflow logo
Warner Bros. logo
Adyen logo
Appcues logo
Bandwidth logo
Checkr logo
ChartMogul logo
Dataminr logo
Gopuff logo
Gorgias logo
LinkedIn logo
Logitech logo
Replicated logo
Rudderstack logo
SAS logo
Scale AI logo
Webflow logo
Warner Bros. logo