> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Notion Webhook Setup Guide

> Configure Notion to deliver events to StackOne.

## Prerequisites

Before continuing, you should have already completed the following for this connector:

<Steps>
  <Step title="Configure the Connector">
    Enable the connector and set up its connector profile in your project. See <a href="/guides/explore-connectors">Managing Connectors</a>.

    <Columns cols={2}>
      <Card title="Connector Profile" href="/connectors/notion/guides/connector-profile/installation-access-token" icon="https://stackone-logos.com/api/notion/filled/png" horizontal>
        Notion - Installation Access Token
      </Card>

      <Card title="Connector Profile" href="/connectors/notion/guides/connector-profile/personal-access-token" icon="https://stackone-logos.com/api/notion/filled/png" horizontal>
        Notion - Personal Access Token
      </Card>

      <Card title="Connector Profile" href="/connectors/notion/guides/connector-profile/oauth-2-0" icon="https://stackone-logos.com/api/notion/filled/png" horizontal>
        Notion - OAuth 2.0
      </Card>
    </Columns>
  </Step>

  <Step title="Link an Account">
    Connect an account using <a href="/guides/embedding-stackone-hub">StackOne Hub</a> or <a href="/guides/auth-link">Auth Link</a>.

    <Columns cols={2}>
      <Card title="Link Account" href="/connectors/notion/guides/link-account/installation-access-token" icon="https://stackone-logos.com/api/notion/filled/png" horizontal>
        Notion - Installation Access Token
      </Card>

      <Card title="Link Account" href="/connectors/notion/guides/link-account/personal-access-token" icon="https://stackone-logos.com/api/notion/filled/png" horizontal>
        Notion - Personal Access Token
      </Card>

      <Card title="Link Account" href="/connectors/notion/guides/link-account/oauth-2-0" icon="https://stackone-logos.com/api/notion/filled/png" horizontal>
        Notion - OAuth 2.0
      </Card>
    </Columns>
  </Step>
</Steps>

<section data-guide-section data-guide-scopes="">
  <h2>Receive Notion webhook events via StackOne</h2>

  <p>Notion has no API to create webhooks — they are set up manually at the workspace level. After you register the StackOne Native Webhook URL in Notion, Notion sends a one-time verification token that must be pasted back into the Notion UI. Because that token arrives at StackOne (not your screen), StackOne forwards it to your outbound webhook so you can read and paste it.</p>

  <Steps>
    <Step title="Create an outbound webhook in StackOne">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>This is where StackOne delivers events — including the verification token you will need.</p>

        <ul>
          <li>Go to the <strong>Webhooks</strong> page in StackOne and click <strong>Add Webhook</strong>.</li>
          <li>Enter a name and a publicly reachable <strong>HTTPS URL</strong> that returns 200 (for testing you can use a [https://webhook.site](https://webhook.site) URL).</li>
          <li>Save the webhook.</li>
        </ul>
      </div>
    </Step>

    <Step title="Connect your Notion account first">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>The Native Webhook URL is only generated after an account is connected, because it embeds the account token used to route inbound events.</p>

        <ul>
          <li>Connect your Notion account in StackOne (Accounts / Hub).</li>
          <li>Save the connector profile.</li>
        </ul>
      </div>
    </Step>

    <Step title="Enable and route the verification event">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>The verification request will only be processed if its event is enabled and routed to a webhook on the profile.</p>

        <ul>
          <li>Open the connector profile and go to the <strong>Events</strong> tab.</li>
          <li>Toggle on <strong>Active Check (Webhook Verification Token)</strong> and select the webhook you created above.</li>
          <li>Toggle on any other Notion events you want (Page Created, Comment Created, etc.) and route them to a webhook.</li>
        </ul>
      </div>
    </Step>

    <Step title="Copy the Native Webhook URL">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>The URL is populated only after the profile is saved.</p>

        <ul>
          <li>Save the profile, close the modal, then reopen the profile from the list.</li>
          <li>Copy the value from the <strong>Native Webhook URL</strong> field.</li>
        </ul>
      </div>
    </Step>

    <Step title="Create the webhook subscription in Notion">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Register the StackOne URL in your Notion integration.</p>

        <ul>
          <li>Go to <a href="https://www.notion.so/profile/integrations" target="_blank" rel="noopener noreferrer">Notion integrations</a> and open your integration.</li>
          <li>Open the <strong>Webhooks</strong> tab and click <strong>+ Create a subscription</strong>.</li>
          <li>Paste the <strong>Native Webhook URL</strong> and click <strong>Create subscription</strong>.</li>
        </ul>
      </div>
    </Step>

    <Step title="Complete verification with the forwarded token">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Notion immediately sends a verification token to the URL. StackOne forwards it to your outbound webhook.</p>

        <ul>
          <li>Open your outbound webhook (e.g., the [https://webhook.site](https://webhook.site) page) and find the delivered event containing `verification_token`.</li>
          <li>Copy the token value.</li>
          <li>Back in Notion, paste it into the <strong>Verification token</strong> field and click <strong>Verify</strong>.</li>
          <li>Once verified, Notion begins delivering events, which StackOne routes to your subscribed webhook(s).</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

## Verify

Your Connector should now be able to receive and process events. Try triggering an event and you should see an Event appear in the Connector logs.