# Notion

Connecting Notion to DuploCloud lets the AI agent read, create, and update pages and databases in your Notion workspace. You create an internal integration in Notion to generate an API token, then register it as a provider in DuploCloud.

***

## Part 1 — Create a Notion Internal Integration

### Step 1 — Open Internal Integrations

Go to [notion.so/profile/integrations/internal](https://www.notion.so/profile/integrations/internal). This page lists all internal integrations for your workspace. Click **Create a new integration**.

![Internal integrations page](/files/eUN3JXfuKKbFjSkBAWM2)

### Step 2 — Fill in Integration Details

Give the integration a name (e.g. `DuploCloud-Integration`) and select the **Associated workspace** this integration will have access to. Click **Create**.

![New integration form](/files/IytoBGY56Th0LjmSLCSm)

### Step 3 — Integration Created

A confirmation dialog appears. Click **Configure integration settings** to proceed to the integration configuration page.

![Integration successfully created](/files/6KSZJMtjWBrgr5GHpd3S)

### Step 4 — Copy the Token and Configure Capabilities

On the **Configuration** tab, copy the **Internal integration secret** — this is the API token you will use in DuploCloud.

Under **Capabilities**, you can control exactly what the agent is allowed to do in your workspace:

* **Read content** — allows the agent to read pages and databases
* **Update content** — allows the agent to edit existing pages
* **Insert content** — allows the agent to create new pages and blocks

Enable only the capabilities you need. If Insert and Update content are enabled, the agent can create and modify pages on your behalf when instructed.

![Integration token and capabilities](/files/itCXxI1iZcygrYOyioRx)

### Step 5 — Grant Page Access

Switch to the **Content access** tab and click **Edit access**. Select the pages and databases this integration is allowed to access. The agent will only be able to interact with pages explicitly shared with it here.

![Content access tab — no pages granted](/files/y0GscSs1IvCyGkhvGKIo)

![Manage page access — selecting pages](/files/vKiO4f4DQpccJsypSsgX)

***

## Part 2 — Add the Notion Provider in DuploCloud

### Step 1 — Navigate to Providers > Other

In DuploCloud, go to **Providers** in the left sidebar, select your tenant (e.g. **IT**), and click the **Other** tab. Click **+ Add**.

![Other providers list](/files/sASghibcxRBkWgrVoqC8)

### Step 2 — Fill in the Add Provider Form

In the **Add Provider** form:

* **Name** — a name for this provider (e.g. `Notion-test`)
* **Description** — optional description
* **Type** — select `Other`
* **Account ID** — enter your Notion **Workspace ID**

> **Finding your Workspace ID:** In Notion, go to **Settings** → **General**. Your Workspace ID is listed there.

Click **Create Provider**.

![Add Provider form](/files/sClTtrv3Bd0GlLcktjH1)

### Step 3 — Provider Created

The provider appears in the **Other** tab with a success notification.

![Provider created successfully](/files/lhSaWElH6RoeQrIC4FhA)

### Step 4 — Add a Credential

Click on your new provider to open it, then go to the **Credentials** tab and click **+ Add**.

In the **Add Credential** modal:

* **Name** — a name for this credential (e.g. `Notion-Cred`)
* **Credential Fields** — click **+ Add Credential Field** and add:
  * **Key** — `IntegrationKey`
  * **Type** — `String`
  * **Sensitive** — on
  * **Value** — paste the integration token copied from Notion (starts with `ntn_...`)

Click **Create**.

![Add Credential with IntegrationKey](/files/oUSp4iyJkDSwsE0m66bN)

### Step 5 — Add a Scope

On the **Scope** tab, click **+ Add**.

* **Name** — a name for this scope (e.g. `Notion-test-scope`)
* **Credential** — select the credential you just created

Click **Create**.

![Add Scope](/files/gOgbjDWF3lOFMOtwUtoL)

***

## Part 3 — Use the Notion Scope in a Ticket

### Step 1 — Create a Ticket

Go to **HelpDesk** and create a new ticket. In the scope selector, choose the Notion scope you created under your provider.

![Scope dropdown with Notion scope selected](/files/E91iTgCV7xv5DDwoTZ5o)

Type your request — for example, asking the agent to read a page and act on its contents — and click **Create Ticket**.

![Ticket ready with Notion scope](/files/5JUymnGEFWQqN3wXnMib)

### Step 2 — Agent Output

The agent accesses your Notion workspace using the integration token, reads the specified page, and executes the request. Results appear in the ticket thread.

![Agent output — reading and following Notion page instructions](/files/1RIpbZev1QwabT5vVm3f)


---

# 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://docs.duplocloud.com/docs/getting-started/integrating-providers/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.