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 siteNotion API Integrations
Build and run workflows using the Notion API. Use 1000s of source-available triggers and actions across 2,000+ apps. Or write custom code to integrate any app or API in seconds.
Overview#
Notion's API allows for the creation, reading, updating, and deleting of pages, databases, and their contents within Notion. Leveraging Pipedream's platform, you can build workflows that connect Notion with a myriad of 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.
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-24of2,000+apps by most popular
Example Use Cases#
Content Sync Between Notion and a CMS: Automatically push new blog posts from a Notion database to a CMS like 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.
Popular Notion Triggers#
Emit new event when a database is created. Note: Databases must be shared with your Pipedream Integtration to trigger event.
Emit new event when a page or one of its sub-pages is updated.
Emit new event when a page in a database is updated. To select a specific page, use Updated Page ID instead
Popular Notion Actions#
Creates and appends blocks to the specified parent. See the documentation
Creates a page from a parent page. The only valid property is title. See the documentation
Creates a new page copied from an existing page block. See the docs
Troubleshooting#
Note: After creating a new database, please reconnect your account and select it to enable access to Pipedream.
Please reach out to the Pipedream team with any technical issues or questions about the Notion integration. We're happy to help!
Authentication#
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:
- 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 - accessToken
POSThttps://api.notion.com/v1/oauth/tokencontent-type:application/x-www-form-urlencodedaccept:application/jsonredirect_uri={{oauth.redirect_uri}}&grant_type=authorization_code&code={{oauth.code}}