The first step to building any integration (internal or public) is to create a new integration in Notion’s integrations dashboard: https://www.notion.com/my-integrations.
- Click +
New integration. - Enter the integration name.
- (Optional) If you're using the completed sample app with the comment form as well, update the to allow comment interactions.
Capabilities
Navigating the integrations dashboard to create a new internal integration.
The integration will be internal by default. If you are building a public integration, you will need to make it public under the tab.Distribution
API requests require an API secret to be successfully authenticated. Visit the tab to get your integration’s API secret (or “Internal Integration Secret”).Secrets
👍 Keep your API secret a secret!
Any value used to authenticate API requests should always be kept secret. Use environment variables and avoid committing sensitive data to your version control history.
If you do accidentally expose it, remember to “refresh” your secret.
Settings - Plugin - Notion Search - API Secret
API requests require an API secret to be successfully authenticated. Visit the Secrets tab to get your integration’s API secret (or “Internal Integration Secret”).
To give the integration permission, you will need to:
- Pick (or create) a Notion page.
- Click on the ... More menu in the top-right corner of the page.
... - Scroll down to .
+ Add Connections - Search for your integration and select it.
- Confirm the integration can access the page and all of its child pages.
Give your integration permission to add a database to a page.
Your integration can now make API requests related to this Notion page and any of its children.
If you are building a public integration, use the authorization instructions included in the Authorization guide instead.
🚧 If your API requests are failing, confirm you have given the integration permission to the page you are trying to update. This is a common cause of API request errors.
ns {query}