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).