Knowledge
Notion
Search and edit Notion pages and databases from Atlas.
What this connector does
- Index Notion pages and databases the integration is invited to.
- Surface Notion search results inside Atlas.
- Link Atlas tasks to Notion pages, keeping the titles in step in both directions.
- Listen for page update events where available.
Before you begin
- You are an owner or administrator of your Atlas workspace.
- You can sign in to your Notion account and approve access for Atlas.
- Atlas looks after the Notion app on its side, so there is nothing for you to create or copy.
How to connect
Open Notion in Integrations
In Atlas, open Integrations and select Notion.
Press Connect
Atlas sends you to Notion to sign in. Sign in with the account you want to connect.
Approve access
Review the permissions that Notion lists and approve them. Atlas returns you to the connector page, which then shows the connection.
Check the connection
Select Test connection on the connector page. A passing result means Atlas can read from Notion.
Permissions Atlas asks for
read_contentupdate_contentinsert_contentSetup checklist
- Confirm you are an owner or administrator of your Atlas workspace.
- Open Integrations and select the connector.
- Press Connect and sign in to Notion.
- Review the permissions that Notion lists and approve them.
- Select Test connection and read the result.
Troubleshooting
object_not_found
The integration was not invited to the page or database. Share it from Notion.
rate_limited
Notion limits requests to 3 per second per integration. Atlas backs off automatically.
Connect says Notion is not available yet
Atlas has not enabled Notion for this deployment, so there is nothing for you to configure. Check again later.
The sign-in was cancelled
If you close the Notion screen or choose Cancel, Atlas does not connect. Press Connect again and approve the access.
Atlas asks you to reconnect
Notion can end a connection when access is revoked or a password changes. Press Reconnect on the connector page and approve the access again.
Event notifications
Notion does not send Atlas event notifications. Atlas reads your shared pages and databases when you ask it to, so what you see is current at the moment you open it.
Events Atlas listens for
- Page updated (polled)
- Database row added (polled)
- Page archived (polled)
Disconnect and data deletion
- Click Disconnect on the Atlas Notion connector page.
- Open My integrations in Notion and delete the Atlas Connector integration.
- Atlas removes cached page metadata within 24 hours of disconnect.
When you are ready, open the live connector page and press Connect to finish connecting Notion.
Open the Notion connector page