Skip to main content

​
Benefits of Connecting Notion to Windmill

Connecting Notion to Windmill ensures planning, documentation, and project work becomes visible in performance conversations — without employees needing to summarize or translate their work manually.
  • Automatically captures contributions to docs, specs, research, and project planning
  • Recognizes the invisible but critical thinking work that often gets missed in reviews
  • Reduces the time managers and employees spend preparing for review cycles
  • Helps managers coach using real examples of communication, clarity, and collaboration
  • Makes performance reviews more fair and grounded in the full scope of someone’s work
Windmill turns ongoing Notion activity into meaningful context for reflection, coaching, and evaluation.

​
Connection Types

When connecting Notion to Windmill, you’ll choose between two connection types. The setup flow is the same for both — the difference is who can see the synced data.

​
Account

An account connection is set up on behalf of your organization. Any data synced from this integration is globally available to all Windmill members in your company. This is ideal when your team uses shared Notion workspaces and you want everyone to benefit from the synced context.
Only admins can create account connections.

​
Personal

A personal connection is tied to an individual. Any data synced from this integration is only visible to you — no one else in your Windmill organization can see it. This is a good option if you want to connect personal Notion pages or private notes without sharing them across your team.
Any Windmill member can create a personal connection.

​
Choosing a Connection Type

AccountPersonal
Who can create itAdmins onlyAny member
Data visibilityAll Windmill membersOnly you
Best forShared workspaces, team docs, project pagesPrivate notes, personal pages

​
Setting Up the Notion Integration

1

Go to Integrations

Navigate to Integrations in your Windmill settings.
2

Select Notion

Find Notion in the list of available integrations and click Connect.
3

Choose your connection type

Select Account to connect on behalf of your organization, or Personal to connect your own account.
4

Approve access in Notion

You’ll be redirected to Notion to approve access for Windmill.Notion permissions screen showing the access Windmill requestsWindmill will request permission to:
  • View pages you select
  • View comments within pages you select
  • View workspace users and their emails
Click Select pages to move forward.
5

Choose which pages to share

Select the pages you’d like Windmill to access. Only the pages you explicitly select will be visible to Windmill.Notion page selection screen for choosing which pages to shareFrom here, you can:
  • Browse your Teamspaces and Private sections
  • Select all or Deselect all pages at once
  • Use the search bar to quickly find specific pages
  • Expand folders to include or exclude subpages
After you’ve made your selections, click Allow access to complete setup.

​
Managing Visibility and Access

You can update your integration permissions or disconnect at any time by going to Settings → Integrations → Notion → Manage access. From there, you can:
  • Reconnect to Notion if access expires
  • Adjust which pages Windmill can view
  • Disconnect the integration entirely
If a member with a personal connection is archived, their personal Notion connection is automatically removed.

​
Best Practices

  • Share only pages relevant to your team’s use of Windmill (e.g., meeting notes, team goals, or planning docs).
  • Use an account connection for shared team workspaces so all members benefit from the context.
  • Use a personal connection for private notes or pages you don’t want visible to others.
  • Revisit your integration settings if your Notion workspace structure changes.
  • Keep sensitive or unrelated pages unselected to maintain privacy and data security.

​
FAQs

Yes. An admin can set up an account connection for shared workspaces, and individual members can also create their own personal connections for private pages. The two work independently.
An account connection syncs data that’s visible to all Windmill members in your organization. A personal connection syncs data that’s only visible to you. The setup process is the same for both — the difference is who can see the synced data.
Only admins can create account connections. Any Windmill member can create a personal connection.
When a member is archived in Windmill, their personal Notion connection is automatically removed and the associated data is no longer accessible.