Skip to main content

Connect Notion

2 auth methods · updated 2026-10-01

Notion connects with an integration secret or with Notion's own sign-in. With the secret route there is one step people miss: Notion integrations only see pages you explicitly share with them.

www.notion.so ↗

Before you start

  • For the secret route: create an integration at notion.so/profile/integrations. The secret starts with ntn_ or secret_.
  • Share the pages or databases you want agents to use with that integration. It cannot see anything else.
  • For OAuth: sign in with Notion and approve access. Nothing to copy.

API key

Uses your own credential — Verslay stores it encrypted

Connectable today
  1. 1
    Sign in to Notion
    Open https://www.notion.so and sign in to the account you want to connect.
  2. 2
    Create the API key
    Generate a new API key from the API or developer settings in your Notion dashboard.
  3. 3
    Copy it immediately
    Notion usually shows the full API key only once, right after you create it. Store it somewhere safe before closing the page.
  4. 4
    Connect in Verslay
    In the Verslay Hub, open Connections, find Notion, and paste the API key into the API Key field.
  5. 5
    Verify
    The connection flips to Connected. Run any read-only action once to confirm the credential has the right scopes.
  6. 6
    Rotate safely
    When you rotate later: connect the new credential first, confirm it works, then revoke the old one.

What you’ll paste into Verslay

API Key

Your Notion integration secret (starts with 'ntn_' or 'secret_'). Create one at notion.so/profile/integrations, then share your pages with the integration.

required · secret

What you can run once Notion is connected

If it does not connect

Notion connected, but agents cannot find my pages.
With an integration secret, share each page or database with the integration inside Notion. It sees only what is shared.
The secret is rejected.
It should start with ntn_ or secret_. Create a fresh one at notion.so/profile/integrations and paste it again.

Notion connection FAQ

Why can't Verslay see my Notion pages?

Integrations only see pages you share with them. Share the pages or databases with your integration in Notion, then try again.

Where do I create a Notion integration secret?

At notion.so/profile/integrations. The secret starts with ntn_ or secret_.

Do I have to use a secret?

No. OAuth is also available: sign in with Notion and approve access.

Connect Notion once — every agent can use it

Verslay agents share your connections. Connect Notion in the Hub and every use-case that needs it lights up — no per-agent setup.

Open the Hub →