Last updated
November 12th, 2026

Notion Setup

You connect Notion from Services in WorkSights. Once connected, Notion sends activity to WorkSights through its webhook framework. Only activity that occurs after the connection, and only on pages explicitly shared with WorkSights, appears.

Only Owners, Executives and Admins can connect services.

For an overview of how Notion activity appears in WorkSights, see Notion Overview.

Connecting Notion

Step 1: Start the Connection

  1. Go to Services in the top navigation.
  2. Find Notion in the list.
  3. Click Connect Notion.
Notion card on the WorkSights Connected Services page

Step 2: Authorize WorkSights in Notion

Notion asks you to authorize the integration. WorkSights requests read-only access to view selected pages and databases, view comments on those pages, view file activity, and view workspace users and their email addresses for mapping. No write permissions are requested. WorkSights cannot create, edit or delete anything in your Notion workspace.

The person authorizing the integration needs sufficient permissions in the Notion workspace to grant this access.

Step 3: Choose Pages or Databases

Notion's access model is page-specific, not workspace-wide. During authorization, you select exactly which pages and databases WorkSights can see. You can grant access to entire teamspaces or to individual top-level pages.

This grant does not extend to new pages created later. A new top-level page created after setup needs to be shared with WorkSights separately, even inside a teamspace you have already shared. This is the most common reason activity appears to be missing for new work.

To add a page or database after setup, there is no need to disconnect and reconnect. Go to Notion's own Settings → Connections → WorkSights and add the new page or database there. WorkSights begins receiving events for it from that point.

After selecting the pages or spaces to share, click Allow Access to complete authorization.

Step 4: Review User Mapping

WorkSights imports users from the Notion workspace and matches them to WorkSights users by email. Only person-type users are imported. Notion bot users are excluded automatically.

Users tab of the Notion service in WorkSights showing remote user mapping

Open the Users tab to review the mappings. For any user that did not map automatically, select the correct WorkSights profile from the dropdown.

Only mapped users' activity is included in activity estimates. If a user is not mapped when their activity arrives, WorkSights holds the event and surfaces it once mapping is complete, rather than discarding it.

What Happens Next

Once connected, Notion sends page edits, property changes, database row activity, comments and file events to WorkSights, but only for the pages and databases shared during setup.

Overview tab of the Notion service in WorkSights

New activity appears on the timeline within about 20 minutes.

You can review and update connection status, shared pages and user mappings at any time. Page and database sharing changes happen on Notion's side under Settings → Connections → WorkSights. Mapping and connection status are managed from the Notion Service Details page.

Related Guides

Notion Overview