-
Notifications
You must be signed in to change notification settings - Fork 5.5k
Notion API Update #18317
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Notion API Update #18317
Changes from all commits
822de7f
1e6f76c
66ef164
85cb57f
fe0fcba
4abd414
4613aca
350242a
9974ceb
9a88944
a50e854
85169c4
f979469
a6fc9fb
af12d9c
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change | ||||
---|---|---|---|---|---|---|
@@ -1,25 +1,25 @@ | ||||||
# Overview | ||||||
|
||||||
The Notion Create Page from Database action allows you to add pages to a Notion Database. | ||||||
The Notion Create Page from Data Source action allows you to add pages to a Notion Data Source. | ||||||
|
||||||
This action features easy to use dropdowns that automatically populate your databases as well as your database's properties, also known as columns. | ||||||
This action features easy to use dropdowns that automatically populate your data source as well as your data source's properties, also known as columns. | ||||||
|
||||||
This action interacts with the [Notion create a Page API endpoint](https://developers.notion.com/reference/post-page). The Database selected in the `Parent Database ID` is used as the `parent_id` parameter to that endpoint so the page is added to your databaset . | ||||||
This action interacts with the [Notion create a Page API endpoint](https://developers.notion.com/reference/post-page). The Data Source selected in the `Parent Data Source ID` is used as the `parent_id` parameter to that endpoint so the page is added to your data source. | ||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. API terminology: Notion uses a parent object, not parent_id. -...used as the `parent_id` parameter to that endpoint...
+...used in the `parent` object (e.g., `parent: { data_source_id: "<ID>" }`) for that endpoint... 📝 Committable suggestion
Suggested change
🤖 Prompt for AI Agents
|
||||||
|
||||||
# Getting Started | ||||||
|
||||||
<iframe width="560" height="315" src="https://www.youtube.com/embed/wciWsu564_0" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe> | ||||||
|
||||||
[Follow this short 4 minute guide to connect your Notion account and add new Database pages](https://youtu.be/wciWsu564_0) | ||||||
[Follow this short 4 minute guide to connect your Notion account and add new Data Source pages](https://youtu.be/wciWsu564_0) (note: as of 2025-09-02, Databases are divided into multiple Data Sources, which are the entities that contain the pages) | ||||||
|
||||||
### Props | ||||||
|
||||||
When using the **Create Page from Database** action, there are several props to define: | ||||||
When using the **Create Page from Data Source** action, there are several props to define: | ||||||
|
||||||
1. `Notion Account` - see the **Accounts** section below. | ||||||
2. `Parent Database ID` - the database to add a page to. | ||||||
2. `Parent Data Source ID` - the data source to add a page to. | ||||||
3. `Meta Types` - an icon or cover to add to the new page (optional). | ||||||
4. `Property Types` - one or more properties to add to the new page that correspond with columns in the database. | ||||||
4. `Property Types` - one or more properties to add to the new page that correspond with columns in the data source. | ||||||
5. `Page Content` - the content of the page that appears when it's opened in a side view. | ||||||
|
||||||
Each selected `Property Type` will also add a new prop for that given column. | ||||||
|
@@ -37,12 +37,12 @@ Each selected `Property Type` will also add a new prop for that given column. | |||||
1. [Create a new workflow](https://pipedream.com/new). | ||||||
2. Select your trigger (HTTP, Cron, etc.). | ||||||
3. Click on the **+** button below the trigger step, and search for "Notion". | ||||||
4. Select the **Create Page from Database** action. | ||||||
4. Select the **Create Page from Data Source** action. | ||||||
5. Click the **Connect Account** button near the top of the step. This will prompt you to select any existing Notion accounts you've previously authenticated with Pipedream, or you can select a **New** account. Clicking **New** opens a new window asking you to allow Pipedream access to your Notion workspaces and pages. Choose the workspaces and pages where you'd like to install the app, then click **Allow**. | ||||||
6. That's it! You can now connect to the Notion API using any of the Slack actions within a Pipedream workflow. | ||||||
|
||||||
# Troubleshooting | ||||||
|
||||||
If your database doesn't appear under the options, try deleting your Notion account connection and reconnecting. | ||||||
If your data source doesn't appear under the options, try deleting your Notion account connection and reconnecting. | ||||||
|
||||||
There's an issue with Notion Databases not appearing in the options if the Database was created _after_ you connected your Notion account to Pipedream. | ||||||
There's an issue with Notion Data Sources not appearing in the options if the Data Source was created _after_ you connected your Notion account to Pipedream. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
💡 Verification agent
🧩 Analysis chain
Confirm Notion supports
link_to_page
withdata_source_id
.The new child type
child_data_source
likely maps tolink_to_page: { type: "data_source_id", data_source_id }
, but this API is very new. Please verify against the 2025‑09‑03 docs.🌐 Web query:
💡 Result:
Answer: As of 2025-09-03, the link_to_page block supports only type = "page_id" and type = "database_id". data_source_id is not listed as a valid link_to_page type. See the "Link to Page block type" section showing examples using page_id and database_id [1], and the 2025-09-03 changelog note about databases/data_sources (no change adding data_source_id to link_to_page) [2].
Sources:
[1] Notion Developers — "Synced Block, Link to Page and Template block types are now supported in the API" — Link to Page block type (example uses "type": "page_id" and mentions "database_id"). (developers.notion.com)
[2] Notion Developers — "Changes by version" (2025-09-03 entry describing /v1/databases → /v1/data_sources reorganization). (developers.notion.com)
Citations:
Replace/remove unsupported link_to_page type "data_source_id" — Notion docs (2025-09-03) list only "page_id" and "database_id".
File: components/notion/actions/common/base-page-builder.mjs
Lines: 213-220
Notion docs (Link to Page block type, 2025-09-03) do not list
data_source_id
; change this to use a supported type (page_id
ordatabase_id
) or remove/replace the child_data_source code path and verify block.id maps to the chosen id.🤖 Prompt for AI Agents