Overview

This guide will walk you through the steps to create your own Notion OAuth integration and configure it as partner credentials in Merge.

Prerequisites

Before linking setting up your partner credentials, you will need:

• A Notion account. You can sign up for one here.

• You must be a Workspace Owner of the Notion account

Instructions

Step 1: Create a Notion Integration

1. In your Notion workspace, navigate to Settings → Integrations tab

2. Click Develop your own integrations at the bottom

3. You'll be redirected to My integrations in your browser

4. Click + New integration

   

5. Provide a Name for your integration

6. Optionally, upload an image to use as a Logo

7. Choose Public as the integration type to enable OAuth

8. Select the Associated workspace where you want to use this integration

   

9. Complete the integration setup by configuring:

   1. Redirect URIs: Add https://app.merge.dev/oauth/callback

   2. Additional information, including your company name, website, etc

Step 2: Retrieve your OAuth credentials

After creating your integration:

1. Navigate to the OAuth Domain & URIs section

2. Copy your OAuth client ID

3. Copy your OAuth client secret

4. Note the redirect URI: https://app.merge.dev/oauth/callback

Step 3: Add your Notion credentials to Merge

1. Log into your Merge Dashboard

2. Navigate to the Integrations tab

3. Under Knowledge Base, locate the Notion integration

4. Enable the integration using the toggle on the right

5. Click Set up organization-level credentials

6. Enter the following information:

   • OAuth Client ID: Your OAuth client ID from Step 2

   • OAuth Client Secret: Your OAuth client secret from Step 2

   • OAuth Redirect URI: https://app.merge.dev/oauth/callback

7. Click Save