Notion

n otion is a productivity and note taking web application with the notion app in {{product name}} , you can manage the database items, pages, and page content in your notion account requirements to use the notion app in {{product name}} you must have a https //www notion so/signup your notion account must have admin permissions to establish the connection in {{product name}} connect notion and {{product name}} {{product name}} provides two ways to connect to the notion app docid\ t0lp2cni2mrdnfdobwufo docid\ t0lp2cni2mrdnfdobwufo create the internal connection to create a notion internal connection, you first need to docid\ t0lp2cni2mrdnfdobwufo docid\ t0lp2cni2mrdnfdobwufo obtain the internal integration token in notion before you create the internal connection in {{product name}} , you should first obtain an internal integration token in your notion account to obtain the internal integration token log in to your notion account click settings & members > connections > develop or manage integrations from the sidebar or go to the https //www notion so/my integrations click new integration select the associate workspace , fill in the integration name , upload a logo (optional), choose the associated workspace , and click submit go to capabilities , update the requested capabilities, and click save changes go to secrets , click show next to your internal integration token, and copy the token store your token in a safe place you'll use this value in the internal integration token connection field in {{product name}} create the internal connection in {{product name}} once you have your notion internal integration token, you're ready to create the connection in {{product name}} to create the connection log in to your {{product name}} account, add a notion module to your {{scenario singular lowercase}} , and click create a connection in the connection type dropdown, select notion internal optional in the connection name field, enter a name for the connection in the internal integration token field, enter the internal integration token you copied from your notion account click save you've successfully created the connection and can now use the notion app in your {{scenario plural lowercase}} if you want to make changes to your connection in the future, follow the steps docid\ so88fm6pkt0g adkddfzz create the public connection to create the public connection log in to your {{product name}} account, add a notion module to your {{scenario singular lowercase}} , and click create a connection in the connection type dropdown, select notion public optional in the connection name field, enter a name for the connection optional click advanced settings and enter your client credentials see docid\ t0lp2cni2mrdnfdobwufo click save if prompted, authenticate your account, click select pages , select the pages you want make to have access to, and click allow access you've successfully created the connection and can now use the notion app in your {{scenario plural lowercase}} if you want to make changes to your connection in the future, follow the steps docid\ so88fm6pkt0g adkddfzz optional obtain notion client credentials you can create an advanced connection using your notion client credentials to obtain your notion client credentials log in to your notion account click settings & members > connections > develop or manage integrations from the sidebar or go to the https //www notion so/my integrations click new integration select the associate workspace , fill in the integration name , upload a logo (optional), choose the associated workspace , and click submit go to capabilities , update the requested capabilities, and click save changes go to distribution and click the toggle to make the integration public fill in your organization information and click submit field value redirect uris enter the redirect uri https //www integromat com/oauth/cb/notion2 company name name of your company or organization you may use your own name if this does not apply website or homepage used to link to your integration’s website or homepage in your integration page and authentication screens tagline optional a short description of the integration privacy policy url address used to link to your integration’s privacy policy in your integration page and authentication screens terms of use url address used to link to your integration’s terms of use in your integration page and authentication screens support email used to link to your integration’s support email in your integration page and authentication screens notion url for optional template optional url must be for a public notion page use this field if you'd like to duplicate a template into a user's workspace during oauth click continue in the switch to public integration? prompt copy the oauth client id and oauth client secret and save them in a safe place you will not be able to view the oauth client secret more than once you have successfully created your client credentials notion api update starting september 3, 2025 , notion introduced a new api version ( 2025 09 03 ) that supports databases with multiple data sources existing integrations if you already have an existing integration and add a new data source, the old integration will stop working to continue using the existing integration, delete the newly added data source module compatibility the new notion modules work with both single source and multi source databases for any new setups, use the new modules (not the ones marked as legacy ) this ensures your connection stays compatible with future notion updates notion api v1 will be deprecated at an unspecified date in the future to ensure continuity, it is strongly recommended to migrate to the latest version as soon as possible parent identifiers you can use both old and new modules together as long as they reference the same source database however, be aware that they require different parent identifiers use database id for old modules use data source id for new modules module upgrade while upgrading from old modules to new modules within an existing scenario, there are important breaking changes to account for parent type changes from database to data source in the new module if you are using a v2 module after a v1 module, you will need to map the data source id instead of the database id v1 modules do not output the data source id , so you'll need to retrieve the database using the database id from the v1 module identify and map the corresponding data source id to use in the v2 module instant event module update the webhook has been automatically upgraded to the latest version the value of parent type in the webhook output has changed in some cases—from database to data source if you reference parent type in filters or downstream modules, existing mappings may no longer work as expected notion has renamed the database schema updated event to data soure schema updated this change may impact conditions relying on the old event name and will require updates to maintain compatibility add databases to be visible in {{product name}} for the notion internal connection, by default, notion databases do not appear in the database id field > search option you must manually add them to the notion app in {{product name}} from your notion account to add databases from your notion account to the notion app in {{product name}} log in to your notion account enter into the database you want to add to {{product name}} , click on in the top right corner, click add connections , search for and click on the integration you previously created, and click confirm the database is successfully shared and you can now see it in a module's database id > search field retrieve added databases and pages after establishing the connection if new databases or pages are added to the notion account, you must revoke the connection in your notion account and reauthorize the connection in {{product name}} to retrieve the added databases or pages to retrieve the newly added databases and pages log in to your notion account click settings & members > connections > > disconnect all users go to your {{product name}} account connections page, search for your notion connection, and click reauthorize you can now see the newly added databases or pages in your notion {{product name}} connection notion modules after connecting to the notion app, you can use the following types of modules to build your {{scenario plural lowercase}} data source/database item watch data source items create a data source item create a database item (legacy) append a database item content update a data source item get a data source item data source/ database/page watch objects search objects create a database update a database get a database create a data source update a data source get a data source get a page create a page update a page create a database (legacy) get a database (legacy) update a data source (legacy) page content watch page contents list page contents list page property items add the list page property items module to retrieve the complete details of a property item if the output variable contains the has more value this means you must paginate to retrieve all the property item's property values in the page object as notion imposes a 25 page reference limit get a page content append a page content update a page content in the type field, select the page content type that corresponds to the page content id if an incorrect type is selected, an error will appear the page content type cannot be changed using this module delete a page content users list users events watch events events will be delivered only for pages connected to your connection to change the pages with access, create a new connection and select pages in your workspace again other make an api call templates you can look for notion templates in https //www make com/en/templates , where you'll find thousands of pre created {{scenario plural lowercase}} notion resources https //developers notion com/reference/intro