
Table of contents
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
- Go to Services in the top navigation.
- Find Notion in the list.
- Click Connect Notion.

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.

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.

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.