Create own Integration


To be able to access Notion content from third party applications created by us, it is necessary to create an integration that allows such connection. In this article I will show you how to do it step by step.

Create integration

From the left menu, go to Settings and Members > Connections > Develop or manage integrations.

In the new page, we create an integration with the desired name and the required settings:

  • Type of integration:

    • Internal: only available in environments where the creator is an administrator. No verification by Notion is required.
    • Public: can be used by any Notion user. Needs to be verified by Notion.
  • Capabilities: refers to which data the integration will be able to access, either to read, to update or to create. Depending on the purpose of the integration being created, one or the other will be selected.

Once created, we will get an Internal Integration Token. This token is like a kind of password that has to be sent to Notion every time a request is made to its servers from the application that uses the integration.

The last thing to do is to activate the integration in the Notion page where the element that makes use of this integration is located. To do this, click on the three dots in the upper right corner of the page and add the integration created: