# 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="https://1884112744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUolgIxuzQ3OCxgqEYVKM%2Fuploads%2Fxxqu4Zx2xyKd8q1l2yIT%2Fimage.png?alt=media&#x26;token=8c46f357-8414-428f-82dc-e6c452b57897" 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="https://1884112744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUolgIxuzQ3OCxgqEYVKM%2Fuploads%2FfFgPOF9sdP4fdTiwwIFD%2Fimage.png?alt=media&#x26;token=48aafaed-0b7f-48cc-b2ee-f2d0d6f78d90" 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="https://1884112744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUolgIxuzQ3OCxgqEYVKM%2Fuploads%2FMhB8Th2tVqA0UFjKsIjk%2Fimage.png?alt=media&#x26;token=ef7ca0a3-73f5-4a91-8beb-67e55f5d4e3c" 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.\
   &#x20;

   <figure><img src="https://1884112744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUolgIxuzQ3OCxgqEYVKM%2Fuploads%2F1jTEmUpKCtAi2na7LbJ9%2FScreenshot%202025-05-11%20at%204.35.58%E2%80%AFPM.png?alt=media&#x26;token=9f3d63fe-c212-434b-b0fe-f076eb51fd89" alt="" width="375"><figcaption></figcaption></figure>
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.\
   &#x20;

   <figure><img src="https://1884112744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUolgIxuzQ3OCxgqEYVKM%2Fuploads%2FQLsUOsP6kqTpwrQiyTvA%2Fimage.png?alt=media&#x26;token=710ba676-4488-40fd-817e-19f80b9a2b77" 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="https://1884112744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUolgIxuzQ3OCxgqEYVKM%2Fuploads%2FX06MbU8hJo1aohxX3nFH%2Fimage.png?alt=media&#x26;token=9d832c37-cc52-443a-94e0-1b832114ab11" 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 %}