Skip to main content

How to add Notion to Coworker

How to Notion as a connected data source to Coworker

Updated over a month ago

ℹ Only Network Admins can add data sources to Coworker. Contact your network admin for assistance

ℹ You must be an admin for the connected data source in order to successfully connect the tool to Coworker. If you do not have admin access for this tool, you will need to either obtain admin privileges for the tool otherwise add an admin of that tool as an admin on Coworker so they can complete the connection

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

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 Coworker 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

Steps to connect:

  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

  • start_date: Sync pages starting from this date

Did this answer your question?