Overview
Pensero connects to your Notion workspace to analyze work-related documents such as design reviews, PRDs, technical specifications, and engineering notes. We only process content that contributes to understanding engineering work and delivery. All non-work-related information remains private and untouched.
Admins can connect Notion from the Integrations section using the step-by-step instructions below.
What Pensero Reads from Notion
Pensero can ingest both individual pages and Notion database entries. We read metadata only, no private workspace data outside the selected pages.
Pensero retrieves:
Title: Name of the page or document
Content:Text contained in the document
Document Type: Page or database entry
Repository: Location of the document inside Notion
Created By: Document author
Parent Document: If the page belongs to a hierarchy
MIME Type: indicates what kind of file is embedded.
Notion provides block-level metadata, allowing Pensero to identify who wrote or edited each part of a document.
Pensero does not access any files or data outside the pages you explicitly grant access to.
What Pensero Calculates
Pensero analyzes selected Notion documents to:
Understand task context
Evaluate an individual’s work through related documents
Attribute delivery based on active collaboration
Adding Your Notion Workspace (Step-by-Step)
Step 1 - Go to Integrations and Click “Connect”
Open the Integrations page from the left sidebar, find Notion in the list of integrations and select Connect to begin the setup.
Step 2 - Authorize Pensero
Select the Notion account you wish to connect and authorize access.
Step 3 - Choose Your Workspace and Pages
Pick the Notion workspace you want Pensero to read from. Select the specific pages or databases you want Pensero to ingest, then click Allow Access.
Pensero will sync documents periodically.
Adding New Pages or Workspaces
You can connect additional Notion pages or entire workspaces at any time.
Important
To ensure stable and long-term access, Pensero should only be connected and managed by your company’s designated Notion admin.
This prevents access issues if another user later leaves the company or loses permissions.
Do not re-authenticate the Notion integration unless explicitly instructed by Pensero Support.
Adding a Non-Public Document
If you’re adding a non-public (private) Notion page, this only works if it’s handled by the company’s designated Notion admin. If someone else tries to do it from their own Notion account, it will not work reliably.
The page owner should share the Notion document directly with the company’s designated Notion admin.
This avoids relying on personal permissions that could break if the owner or another admin leaves.
Notion → Connections → Pensero panel, without re-authenticating.
This method keeps permissions centralized and avoids unexpected access loss.
Adding New Teamspace Pages
The changes needs to be managed by the Notion admin.
Step 1 - Go to Integrations
Open the Integrations page from the left sidebar and click your Notion workspace.
Step 2 - Add More Pages or Workspaces
Click Manage Access and select the new Teamspace Pages you want Pensero to access. Confirm by clicking Allow access.
Pensero will ingest newly added content during the next sync.
Adding Private or Shared Pages
If a page is private or restricted, first share it with the designated Notion admin.
You can confirm whether your document is synced in this section
Once shared, the admin will see it under Shared and can grant access to Pensero.
After the Notion admin applies the changes, you can search for the document and click Fetch to ingest older documents.
How Pensero Handles Document Updates
Pensero syncs Notion documents periodically and checks for new or updated content on each sync.
Because Notion provides block-level authorship and change metadata, Pensero can identify who wrote or edited each block of content within a document. Delivery is attributed only to new or changed blocks, and assigned directly to the contributors responsible for those changes.
Why attribution differs by document tool
Delivery attribution depends on the data each platform exposes via its API. Tools like Notion provide block-level authorship, while others like Confluence expose document-level updates only. Pensero uses the most accurate signals available for each integration.
Example: how document updates affect delivery points
Alex creates a Performance Review document on Apr 8. Pensero records a delivery point for Alex on Apr 8.
Ben reviews and updates the same document on Apr 14, 6 days later.
Pensero moves Alex's delivery point from Apr 8 to Apr 14, and records Ben as a collaborator. Both Alex and Ben get delivery points reflecting their respective contributions to the document.
If Ben had updated the document on May 10 instead, more than 30 days after Apr 8, Pensero would keep Alex's original delivery point on Apr 8 and create a new delivery point on May 10. Ben would receive delivery points for that new contribution.
Edge cases and limitations
There are a few important edge cases that affect how Notion documents are analyzed and how contributions are attributed in Pensero. Understanding these helps avoid confusion when reviewing metrics.
Skipped documents
If a Notion document is marked as skipped in the Integration page, Pensero will not analyze its content or contributions.
The document text is ignored
No delivery or contribution is attributed from that document
Document creator not present in Pensero
If the creator of a Notion document is not a user in Pensero, the document’s content and contributions are not analyzed.
This is consistent with how Pensero handles other artifacts (such as PRs):
Contributions are only attributed to documents created by users who exist in Pensero.
Why this matters
These rules ensure that:
Sensitive or irrelevant documents are not analyzed
Metrics only reflect work from active team members
Document-based delivery stays consistent with how PRs and other artifacts are treated
If something looks off or unexpected, feel free to reach out to us, we’re happy to review it with you.
How to Review Synced Notion Documents
You can verify everything being ingested by navigating to:
Integrations → Document integrations → [Your Notion Workspace]
You can also use the search bar on this page to quickly find a specific page or database and confirm it is being synced.
In this page, you can review for each document:
Title
Creator
Document type (page or database)
Comments counter (if available)
Last updated at
This helps ensure all expected pages are synced correctly and that nothing important is missing.
How to Remove Synced Notion Document
If you need to stop Pensero from accessing a Notion page, you can remove it directly from the Notion Integration page. How to remove a document:
Step 1 - Go to Integrations
Open the Integrations page from the left sidebar and click your Notion workspace.
Step 2 - Click Manage Access
Step 3 - Review Your Workspace access
Select the Notion workspace, locate the page you want Pensero to stop syncing, and click Remove next to it.
Once removed, Pensero will no longer ingest or update that document in future syncs.