> 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

Sync your Notion databases with Threadly to turn published pages into message buttons. Share SOPs, guides and resources in Slack messages with one click, with no copy-pasting links.

## Overview

Notion is a productivity and note-taking tool. Your team probably writes external-facing docs, guides and pages you'd like to share in your Threadly messages.

Key benefits of the integration:

* **Actions:** Threadly automatically turns each page in the Notion databases you choose into a [Link CTA](/threadly/actions/website-ctas.md) you can attach to any message.
* **Always up to date:** Threadly checks your databases for new pages every day.

Notion is a **Pro** feature, connected once for the whole workspace by a Threadly admin.

## Setup

To connect Notion, create a private (internal) integration in your Notion workspace:

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. Choose **Internal** as the integration type. We suggest a name that shows it's your Threadly connector.\ <br>

   <figure><img src="https://1884112744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUolgIxuzQ3OCxgqEYVKM%2Fuploads%2F4qZsP2EUMM4gHeZ4Hg5k%2Fimage.png?alt=media&#x26;token=4f49bfb4-3f65-4ac9-92de-3696169c64ef" alt="" width="375"><figcaption></figcaption></figure>
3. Give the integration **Read content** access, so Threadly can read your database.\ <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 to your Internal Integration Secret and copy it. Keep it safe, like a password. **Your integration secret is the key to your Notion workspace!**
5. In Threadly, go to **Settings → Integrations → Notion**, click **Enter Integration Token**, and paste your secret. Threadly confirms **You're connected!**
6. Give the integration access to your database. In Notion, open the database page, click the three dots at the top, scroll to **Connections**, and select your Threadly integration.<br>

   <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. Back in **Threadly → Settings → Integrations → Notion**, under **Select databases to sync with Threadly**, choose the databases 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 only creates Actions for pages that are [published to the web](https://www.notion.com/help/public-pages-and-web-publishing). Pages that aren't publicly accessible won't appear as Actions.
{% endhint %}

## Keeping in sync

* Threadly checks your selected databases for new pages **every day**. Click **Sync Now** to sync right away.
* Pages removed from Notion aren't deleted from Threadly automatically. Remove them from **Home → CTAs**.
* If no databases appear, check that they contain public pages and are shared with your integration (step 6).
* If your secret expires or is revoked, the Notion screen shows **Invalid Notion Integration Token**. Click **Reconnect Notion** and enter a new one.