# 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

<figure><img src="https://3561055466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcl1KIMhPQkmG41x5eGvL%2Fuploads%2FwSpcDJX4OlndpqBtbJnr%2FScreenshot%202024-06-13%20at%2016.46.06.png?alt=media&#x26;token=96008fd7-5f74-4dbc-bfc1-242085e4d452" alt=""><figcaption><p>Integration Setup</p></figcaption></figure>

3. 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.
4. Select the Capabilities panel and give the integration the following permissions. Click Save Changes when you're done.

<figure><img src="https://3561055466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcl1KIMhPQkmG41x5eGvL%2Fuploads%2FEviPfG2i74WKvmgomIvv%2FCleanShot%202025-11-26%20at%2002.20.59%402x.png?alt=media&#x26;token=e0d30fba-0420-4de2-811f-bbf4a601556b" alt=""><figcaption></figcaption></figure>

5. 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.

{% hint style="info" %}
**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
{% endhint %}

5. 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

{% embed url="<https://www.loom.com/share/148968444f8a4987aff1929a630e57eb>" %}

{% hint style="info" %}
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
{% endhint %}

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

{% embed url="<https://www.loom.com/share/39457ac702a94b57af5a140a0f261da2?sid=9068f88b-95a4-4375-a76a-ae25a99d864d>" %}

### Information required for the Coworker connection:

* `token`: The integration secret you generated earlier


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://village-labs.gitbook.io/coworker-product-and-developer-docs/data-connections/notion.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.