First-Time Setup (Wizard)
Complete this setup once to allow NotionGate to work with your Notion workspace.
Step 1: Create Integration Token
- - Open notion.so/my-integrations.
- - Create a new integration named NotionGate.
- - Enable read and insert capabilities.
- - Copy the internal integration secret.
Step 2: Paste Token
Paste the token into the wizard input and continue.
Step 3: Give the Integration Access (Crucial)
NotionGate only sees pages and databases your integration has access to. Without access, syncing fails with Not Found errors.
- - Page: open it, choose the ... menu, Connections, and add your integration.
- - Database: its menu often lists only other apps. Open Notion Settings, Connections, your integration, Manage, Page access, and add the database there.
- - Access is inherited: grant it to one parent page and every page and database inside it is covered, including ones you add later.
Step 4: Settings
- - Autostart: start NotionGate when you sign in to your computer, so syncing always runs. Optional.
- - Error reporting: anonymous crash reports. Recommended, it helps fixing bugs.
- - Everything can be changed later under Settings, Application.
Next steps
- - Choose how file links look under Settings, Link appearance (Settings).
- - Create your first mapping (Mappings).
- - Open Health to check that everything works (Health Checks).