> For the complete documentation index, see [llms.txt](https://threadly.gitbook.io/threadly/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://threadly.gitbook.io/threadly/integrations/notion.md).

# Notion

## Overview

Notion is a productivity and note-taking tool. Often, your team might create external-facing content, document, or pages you'd want to share within your Threadly messages.

Key benefits of the integration:

* Actions: Automatically sync documents from a Notion database into Threadly for use in Actions.

## Setup

To connect Notion, you will need a new private/custom integration inside of your Notion workspace. Here's how to create one:

1. Head to your [**Integrations** page in Notion](https://www.notion.so/profile/integrations) and click Create New Integration.

<br>

<figure><img src="/files/l3oKrU5XeqSKZIUgDFoB" alt="" width="563"><figcaption></figcaption></figure>

2. Name your integration, and select the workspace where your pages are stored. You'll also want to select **Internal** for the type of integration you're creating. We'd suggest naming the app to indicate this is your Threadly connector.\ <br>

   <figure><img src="/files/hQIF2gL1Sd3nrhU2weOq" alt="" width="375"><figcaption></figcaption></figure>
3. In order for Threadly to access your Notion database, this integration needs access to **Read content**.\
   \ <br>

   <figure><img src="/files/NhYNmQgsjjLvlPV2SyBq" alt="" width="375"><figcaption></figcaption></figure>
4. Click **Show** next your Internal Integration Secret and copy it. Hold onto it safely, it's like a password. **Remember, your private access token is the key to your Notion instance!**
5. Open the Notion integration from your Threadly settings. Hit **Enter Secret Token** and paste your key in.<br>
6. Upon entering your integration secret, you'll be re-directed back to the Threadly settings screen. But first, we need to ensure that the Threadly integration has access to your database in Notion. To do so, visit your Database page, and hit the three dots at the top. Scroll to the bottom of the menu, and select your Threadly integration in the Connections menu.<br>

   <figure><img src="/files/Mj6ibdzzX3JLYf6BvQ1d" alt="" width="375"><figcaption></figcaption></figure>
7. Finally, navigate back to Threadly > Settings > Notion, where you can select the databases you'd like Threadly to sync pages from.

<figure><img src="/files/rpfH5Crnx3sNe6HpEht2" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="warning" %}
**IMPORTANT:** Threadly will only create Actions and reference pages that are [published to the web](https://www.notion.com/help/public-pages-and-web-publishing). If your database contains pages that are not publicly-accessible, it will not appear as an Action.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://threadly.gitbook.io/threadly/integrations/notion.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.