> ## Documentation Index
> Fetch the complete documentation index at: https://formbricks.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Notion

> The notion integration allows you to automatically send responses to a Notion database of your choice.

<Note>
  If you are on a self-hosted instance, you will need to configure this integration separately. Please follow
  the guides [here](/self-hosting/configuration/integrations) to configure integrations on your self-hosted
  instance.
</Note>

## Formbricks Cloud

1. Click on the `Configuration` tab in the left sidebar and then click on the `Integrations` tab and click on the `connect` button under the `Notion` card.

<img src="https://mintcdn.com/formbricks/Q9LOxgpWHulOxfHK/images/xm-and-surveys/core-features/integrations/notion/integrations-tab.webp?fit=max&auto=format&n=Q9LOxgpWHulOxfHK&q=85&s=aabbd5dcf9020dc7af97088ac06179d0" alt="Formbricks Integrations Tab" width="3534" height="1988" data-path="images/xm-and-surveys/core-features/integrations/notion/integrations-tab.webp" />

1. Now click on the "Connect with Notion" button to authenticate yourself with Notion.

<img src="https://mintcdn.com/formbricks/hX4eoMhsUTcFz4G1/images/xm-and-surveys/core-features/integrations/notion/connect-with-notion.webp?fit=max&auto=format&n=hX4eoMhsUTcFz4G1&q=85&s=6a4edd9694d3941a51f3289b29dc6887" alt="Connect Formbricks with your Notion account" width="3046" height="1624" data-path="images/xm-and-surveys/core-features/integrations/notion/connect-with-notion.webp" />

1. You will now be taken to the Notion OAuth page where you can select the Notion account you want to use for the integration

2. Once you have selected the account and databases and completed the authentication and authorization process, you will be taken back to Formbricks Cloud and see the connected status as below:

<img src="https://mintcdn.com/formbricks/PoRbKmWNh09zaWpR/images/xm-and-surveys/core-features/integrations/notion/notion-connected.webp?fit=max&auto=format&n=PoRbKmWNh09zaWpR&q=85&s=951a18a0a6a97257b17bc3c041198d87" alt="Formbricks is now connected with Notion" width="2940" height="1292" data-path="images/xm-and-surveys/core-features/integrations/notion/notion-connected.webp" />

<Note>
  Before the next step, make sure that you have a Formbricks Survey with at least one question and a Notion
  database in the Notion account you integrated.
</Note>

1. Now click on the "Link New Database" button to link a Notion database with Formbricks and a modal will open up.

<img src="https://mintcdn.com/formbricks/PoRbKmWNh09zaWpR/images/xm-and-surveys/core-features/integrations/notion/link-survey-with-database.webp?fit=max&auto=format&n=PoRbKmWNh09zaWpR&q=85&s=19cced7d1d3f5cef9d2e1248013fd024" alt="Link Formbricks with a Notion database" width="2730" height="1362" data-path="images/xm-and-surveys/core-features/integrations/notion/link-survey-with-database.webp" />

1. Select the Notion database you want to link with Formbricks and the Survey. On doing so, you will be asked to map formbricks' survey questions with selected databases' column. Complete the mapping and click on the "Link Database" button.

<img src="https://mintcdn.com/formbricks/PoRbKmWNh09zaWpR/images/xm-and-surveys/core-features/integrations/notion/link-with-databases.webp?fit=max&auto=format&n=PoRbKmWNh09zaWpR&q=85&s=56205fa316707f7fa7355cc45680f320" alt="Question to notion database column mapping" width="2242" height="1700" data-path="images/xm-and-surveys/core-features/integrations/notion/link-with-databases.webp" />

1. On submitting, the modal will close and you will see the linked Notion database in the list of linked Notion databases.

<img src="https://mintcdn.com/formbricks/PoRbKmWNh09zaWpR/images/xm-and-surveys/core-features/integrations/notion/list-linked-databases.webp?fit=max&auto=format&n=PoRbKmWNh09zaWpR&q=85&s=9106829aecd0129e0176ae5ce1d92cc2" alt="List of linked notion databases" width="2998" height="1048" data-path="images/xm-and-surveys/core-features/integrations/notion/list-linked-databases.webp" />

Congratulations! You have successfully linked a Notion database with Formbricks. Now whenever a response is submitted for the linked survey, it will be automatically added to the linked Notion database.

## Setup in self-hosted Formbricks

Enabling the Notion Integration in a self-hosted environment requires a setup using Notion account and changing the environment variables of your Formbricks instance.

1. Sign up for a [Notion](https://www.notion.so/) account, if you don't have one already.

2. Go to the [my integrations](https://www.notion.so/my-integrations) page and click on **New integration**.

3. Fill up the basic information like **Name**, **Logo** and click on **Submit**.

4. Now, click on **Distribution** tab on the sidebar. A text will appear which will ask you to make the integration public. Click on that toggle button. A form will appear below the text.

5. Now provide it the details such as requested. Under **Redirect URIs** field:

   * If you are running formbricks locally, you can enter `http://localhost:3000/api/v1/integrations/notion/callback`.

   * Or, you can enter `https://<your-public-facing-url>/api/v1/integrations/notion/callback`

6. Once you've filled all the necessary details, click on **Submit**.

7. A screen will appear which will have **Client ID** and **Client secret**. Copy them and set them as the environment variables in your Formbricks instance as:

   * `NOTION_OAUTH_CLIENT_ID` - OAuth Client ID

   * `NOTION_OAUTH_CLIENT_SECRET` - OAuth Client Secret

Voila! You have successfully enabled the Notion integration in your self-hosted Formbricks instance. Now you can follow the steps mentioned in the [Formbricks Cloud](#formbricks-cloud) section to link a Notion database with Formbricks.

## Remove Integration with Notion Account

To remove the integration with Slack Workspace,

1. Visit the Integrations tab in your Formbricks Cloud dashboard.

2. Select "Manage" button in the Slack card.

3. Click on the "Delete Integration" button.

4. It will now ask for a confirmation to remove the integration. Click on the "Delete" button to remove the integration. You can always come back and connect again with the same Notion Account.

<img src="https://mintcdn.com/formbricks/hX4eoMhsUTcFz4G1/images/xm-and-surveys/core-features/integrations/notion/delete-connection.webp?fit=max&auto=format&n=hX4eoMhsUTcFz4G1&q=85&s=f71521075d194636638394b15e2d66b7" alt="Delete Notion Integration with Formbricks" width="2214" height="868" data-path="images/xm-and-surveys/core-features/integrations/notion/delete-connection.webp" />

Still struggling or something not working as expected? [Join our Github Discussions](https://github.com/formbricks/formbricks/discussions) and we'd be glad to assist you!
