Notion

Prerequisites

  • A Notion account with sufficient access to the Workspace & Pages you wish to sync with Coworker.

Generating the credentials

  1. Go to https://www.notion.so/my-integrations to start the api key process.

  2. Click "New Integration"

    1. Leave the integration type as Internal

    2. Select the workspace you want the integration to access

    3. Give it the name "coworker-connect"

    4. Click Submit

Integration Setup
  1. Show and copy your integration secret. If you ever refresh your integration secret, we will need to update it in Coworker for the connection to continue to work.

  2. Select the Capabilities panel and give the integration the following permissions. Click Save Changes when you're done.

Capabilities for the integration
  1. For each Top-level Page or Teamspace you want to have connected to Coworker, you'll need to enable the integration. Note that you only need to add Village to the top-level Pages or Teamspaces that are nested directly under your Workspace. Everything that is in turn nested within these Pages or Teamspaces will also get connected.

IMPORTANT CALLOUT: The Notion Connector does not pull in user page access restrictions. This means that every Top-level Page or Teamspace and all respective child pages will be ingested into Coworker and made available for all users within your workspace to access

  1. Steps:

    1. Navigate to Settings

    2. Click Connections

    3. Go to 'Coworker-connect' (or whatever you have named the Coworker Connection) and click the "..." and select 'Manage in developer portal'

    4. Select 'Access' then 'Edit access' and select the Teamspace pages you want to connect to Coworker

You can also remove a page or subset of pages from a connected Teamspace. It is important you do this before you Notion pages are indexed within Coworker. Flag this to your account representative so they can guide you through the process

Steps to remove the connection for a subset of pages:

  1. Navigate to the page you wish to remove

  2. Click on the "..." in the top right

  3. Scroll down to Connections

  4. Hover over the "Coworker Connect" integration and click Disconnect

  5. Click confirm

Information required for the Coworker connection:

  • token: The integration secret you generated earlier

Last updated

Was this helpful?