Skip to main content

​
Prerequisites

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

Configure the Connector

Enable the connector and set up its connector profile in your project. See Managing Connectors.
https://stackone-logos.com/api/notion/filled/png

Connector Profile

Notion - Installation Access Token
https://stackone-logos.com/api/notion/filled/png

Connector Profile

Notion - Personal Access Token
https://stackone-logos.com/api/notion/filled/png

Connector Profile

Notion - OAuth 2.0
2

Link an Account

Connect an account using StackOne Hub or Auth Link.
https://stackone-logos.com/api/notion/filled/png

Link Account

Notion - Installation Access Token
https://stackone-logos.com/api/notion/filled/png

Link Account

Notion - Personal Access Token
https://stackone-logos.com/api/notion/filled/png

Link Account

Notion - OAuth 2.0

​
Receive Notion webhook events via StackOne

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.

1

Create an outbound webhook in StackOne

This is where StackOne delivers events — including the verification token you will need.

  • Go to the Webhooks page in StackOne and click Add Webhook.
  • Enter a name and a publicly reachable HTTPS URL that returns 200 (for testing you can use a https://webhook.site URL).
  • Save the webhook.
2

Connect your Notion account first

The Native Webhook URL is only generated after an account is connected, because it embeds the account token used to route inbound events.

  • Connect your Notion account in StackOne (Accounts / Hub).
  • Save the connector profile.
3

Enable and route the verification event

The verification request will only be processed if its event is enabled and routed to a webhook on the profile.

  • Open the connector profile and go to the Events tab.
  • Toggle on Active Check (Webhook Verification Token) and select the webhook you created above.
  • Toggle on any other Notion events you want (Page Created, Comment Created, etc.) and route them to a webhook.
4

Copy the Native Webhook URL

The URL is populated only after the profile is saved.

  • Save the profile, close the modal, then reopen the profile from the list.
  • Copy the value from the Native Webhook URL field.
5

Create the webhook subscription in Notion

Register the StackOne URL in your Notion integration.

  • Go to Notion integrations and open your integration.
  • Open the Webhooks tab and click + Create a subscription.
  • Paste the Native Webhook URL and click Create subscription.
6

Complete verification with the forwarded token

Notion immediately sends a verification token to the URL. StackOne forwards it to your outbound webhook.

  • Open your outbound webhook (e.g., the https://webhook.site page) and find the delivered event containing verification_token.
  • Copy the token value.
  • Back in Notion, paste it into the Verification token field and click Verify.
  • Once verified, Notion begins delivering events, which StackOne routes to your subscribed webhook(s).

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