Log InSign Up
Log InSign Up
Back to connector

LogoNotion Integration Development Guide

Add white-label customer-facing integration with Notion into your app with just a few lines of code.

Create Notion App

Get a step-by-step guide on how to create a Notion application here: https://developers.notion.com/docs/authorization. You will need to create a "Public Integration". Don't forget to set the redirect URL in your application to https://api.integration.app/oauth-callback

Configure the app parameters in the integration.app platform

  • Add the Notion app from store in the Integration.app console
  • Click Configure & Test
  • In the Parameters section, select a Use custom parameters toggle / Edit Parameters
  • Fill in Client Id and Client Secret
  • Add scopes your application may require

Data Collections

This connector allows reading users, pages, databases, and other types of data, but only writing Database Items because they have a schema, unlike other types.

If you want to create pages or databases using this connector, you can use corresponding operations or Proxy API.

Configure Webhooks

Notion allows you to subscribe to various event types using webhooks. Follow the steps below to set it up:

  • Go to the integration.app console: External Apps > Notion > then copy the Global Webhooks URL
<img width="1512" alt="Screenshot 2025-05-27 at 14 32 54" src="https://github.com/user-attachments/assets/d2bfef46-7d26-48fb-a2d1-36e783e5e1d9" />
  • Go to your Notion integration page and select your integration
  • Switch to the Webhooks tab
  • Click on "Create a Subscription"
  • Paste the Global Webhooks url you saved earlier into the Webhook URL field and make sure to select all the events to listen to
  • For Notion to send events to this URL, you'd have to verify the endpoint. Notion send's a verification webhook where the body contains the verification token. To get your verification token, go to Activity Logs > External Webhooks then Filter by Integration = "Notion" to see the webhook requests related to Notion.
<img width="1265" alt="Screenshot 2025-05-27 at 14 43 43" src="https://github.com/user-attachments/assets/08578725-51f4-4af5-8ae6-e378993eee8c" />
  • Copy the verification token from the webhook request body
  • Go back to the Integration page on Notion, Click verify, then paste the verification token into the Verification Token field
  • Save changes