--- title: Notion slug: notion image: https://make-cxp-documentation.ams3.digitaloceanspaces.com/apps-center-icons/PREVIEW_notion.png docTags: createdAt: 2025-02-03T13:29:10.709Z --- ::::VerticalSplit{layout="left"} :::VerticalSplitItem ::Image[]{src="https://api.archbee.com/api/optimize/yAufeXqD1oGWOPBNi5MAm-IDfMH0typSh6uPpWunXog-20250710-122742.png" size="50" width="100" height="100" position="center" showCaption="false"} ::: :::VerticalSplitItem Notion is a productivity and note-taking web application. With the Notion app in Make, you can manage the database items, pages, and page content in your Notion account. ::: :::: # Requirements To use the Notion app in Make you must have a [Notion account](https://www.notion.so/signup). Your Notion account must have admin permissions to establish the connection in Make. # Connect Notion and Make Make provides two ways to connect to the Notion app: - [Internal connection](docId\:T0lp2CnI2MRDnfDobwufO) - [Public connection](docId\:T0lp2CnI2MRDnfDobwufO) :::::ExpandableHeading{isOpen="true"} ## Create the internal connection To create a Notion internal connection, you first need to: ::::WorkflowBlock :::WorkflowBlockItem [Obtain the internal integration token in your Notion account](docId\:T0lp2CnI2MRDnfDobwufO). ::: :::WorkflowBlockItem [Create the internal connection in Make](docId\:T0lp2CnI2MRDnfDobwufO). ::: :::: ### Obtain the internal integration token in Notion Before you create the internal connection in Make, you should first obtain an internal integration token in your Notion account. To obtain the internal integration token: ::::WorkflowBlock :::WorkflowBlockItem Log in to your Notion account. ::: :::WorkflowBlockItem Click **Settings & Members** > **Connections** > **Develop or manage integrations** from the sidebar or go to the [My integrations page](https://www.notion.so/my-integrations). ::: :::WorkflowBlockItem Click **New Integration**. ::: :::WorkflowBlockItem Select the **Associate workspace**, fill in the integration **Name**, upload a logo (optional), choose the **Associated workspace**, and click **Submit**. ::: :::WorkflowBlockItem Go to **Capabilities**, update the requested capabilities, and click **Save changes**. ::: :::WorkflowBlockItem 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 Make. ### Create the internal connection in Make Once you have your Notion internal integration token, you're ready to create the connection in Make. To create the connection: ::::WorkflowBlock :::WorkflowBlockItem Log in to your Make account, add a Notion module to your scenario, and click **Create a connection**. ::: :::WorkflowBlockItem In the **Connection type** dropdown, select **Notion Internal**. ::: :::WorkflowBlockItem Optional: In the **Connection name** field, enter a name for the connection. ::: :::WorkflowBlockItem In the **Internal Integration Token** field, enter the internal integration token you copied from your Notion account. ::: :::WorkflowBlockItem Click **Save**. ::: :::: You've successfully created the connection and can now use the Notion app in your scenarios. If you want to make changes to your connection in the future, follow the steps [here](docId\:SO88FM6pkT0G-adKDDfzZ). ::::: :::::ExpandableHeading{isOpen="true"} ## Create the public connection To create the public connection: ::::WorkflowBlock :::WorkflowBlockItem Log in to your Make account, add a Notion module to your scenario, and click **Create a connection**. ::: :::WorkflowBlockItem In the **Connection type** dropdown, select **Notion Public.** ::: :::WorkflowBlockItem Optional: In the **Connection name** field, enter a name for the connection. ::: :::WorkflowBlockItem Optional: Click** Advanced Settings** and enter your client credentials. See [Obtain Notion Client Credentials](docId\:T0lp2CnI2MRDnfDobwufO). ::: :::WorkflowBlockItem Click **Save**. ::: :::WorkflowBlockItem 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 scenarios. If you want to make changes to your connection in the future, follow the steps [here](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: ::::WorkflowBlock :::WorkflowBlockItem Log in to your Notion account. ::: :::WorkflowBlockItem Click **Settings & Members** > **Connections** > **Develop or manage integrations** from the sidebar or go to the [My integrations page](https://www.notion.so/my-integrations). ::: :::WorkflowBlockItem Click **New Integration**. ::: :::WorkflowBlockItem Select the **Associate workspace**, fill in the integration **Name**, upload a logo (optional), choose the **Associated workspace**, and click **Submit**. ::: :::WorkflowBlockItem Go to **Capabilities**, update the requested capabilities, and click **Save changes**. ::: :::WorkflowBlockItem Go to **Distribution** and click the toggle to make the integration public. ::: :::WorkflowBlockItem 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. | ::: :::WorkflowBlockItem Click **Continue** in the **Switch to Public integration?** prompt. ::: :::WorkflowBlockItem 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 Make 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 Make from your Notion account. To add databases from your Notion account to the Notion app in Make: ::::WorkflowBlock :::WorkflowBlockItem Log in to your Notion account. ::: :::WorkflowBlockItem Enter into the database you want to add to Make, 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. ::Image[]{src="https://api.archbee.com/api/optimize/yAufeXqD1oGWOPBNi5MAm--plyNUD8Wv-2nO0FOHNGm-20250709-131244.png" size="84" width="1154" height="626" position="flex-start" alt="Notion Watch Database Items" showCaption="false"} # 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 Make to retrieve the added databases or pages. To retrieve the newly added databases and pages: ::::WorkflowBlock :::WorkflowBlockItem Log in to your Notion account. ::: :::WorkflowBlockItem Click **Settings & members** > **Connections** > **...** > **Disconnect all users**. ::: :::WorkflowBlockItem Go to your Make account **Connections** page, search for your Notion connection, and click **Reauthorize**. ::: :::: You can now see the newly added databases or pages in your Notion Make connection. # Notion modules After connecting to the Notion app, you can use the following types of modules to build your scenarios. :::ExpandableHeading **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 ::: :::ExpandableHeading **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) ::: ::::ExpandableHeading **Page Content** - Watch Page Contents - List Page Contents - List Page Property Items :::hint{type="info"} 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 :::hint{type="info"} 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 :::: :::ExpandableHeading **Users** - List Users ::: ::::ExpandableHeading **Events** - Watch Events :::hint{type="info"} 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. ::: :::: :::ExpandableHeading **Other** - Make an API Call ::: # Templates You can look for Notion templates in [Make's template gallery](https://www.make.com/en/templates), where you'll find thousands of pre-created scenarios. # Notion resources - [Notion API documentation](https://developers.notion.com/reference/intro)