icon

Create and Configure Your Notion Integration

In this guide, you’ll create your Notion integration, get your integration token, and connect it to your Notion database. This will allow your portfolio and blog template to pull content directly from your Notion pages.

Step 1: Open the Notion Integrations Page

  1. 1.a.i.
    Open any browser where you’re already logged in to your Notion account.
  2. 2.b.ii.
    Go to this page:

    🔗 https://www.notion.so/profile/integrations

  3. 3.c.iii.
    Click on “New integration”.
Image

Step 2: Create a New Integration

You’ll now see the “Create integration” form.

Fill in the following details:

  • Name: Type any name you like (for example: “Portfolio CMS Integration”).
  • Associated workspace: Select your Notion workspace.
  • Type: Keep the default Internal selected.
  • Logo (optional): You can upload a logo if you want.

When done, click Save.

You’ll see a message that your integration was successfully created.

Image

Step 3: Configure Integration Settings

After saving, click on the “Configure integration settings” button.

This will open the integration settings page.

In the Capabilities section, update the following:

Content Capabilities

✅ Check Read content

❌ Uncheck everything else

User Capabilities

✅ Check Read user information without email addresses

❌ Uncheck all other options

When done, click the Save button at the bottom right.

You’ll see a small message saying “Integration updated successfully.”

Image

Step 4: Copy Your Integration Secret Token

At the top of this settings page, you’ll see Internal Integration Secret.

  1. 1.a.i.
    Click the Show button to reveal it.
  2. 2.b.ii.
    Copy the full token.
Image

This is your private Notion token - don’t share it publicly.

Step 5: Add the Token to Your .env.local File

  1. 1.a.i.
    Go back to your project folder.
  2. 2.b.ii.
    Open the .env.local file you created earlier.
  3. 3.c.iii.
    Paste your token like this (replace the example value with your own):
Plain Text
NOTION_INTEGRATION_TOKEN=ntn_your_token_here

After pasting your ID, save the file by pressing:

  • Ctrl + S (on Windows)
  • Cmd + S (on Mac)

Step 6: Connect the Integration to Your Database

  1. 1.a.i.
    Open your Notion workspace.
  2. 2.b.ii.
    Go to the Notion database you duplicated earlier for your blog.
  3. 3.c.iii.
    Click the three-dot (•••) menu on the top-right of the database page.
  4. 4.d.iv.
    In the dropdown, hover over Connections.
  5. 5.e.v.
    Find the integration name you created (for example, “Portfolio CMS Integration”).
    Image
  6. 6.f.vi.
    Click it, then select Confirm in the popup.
    Image

Your integration is now connected to your database.

Step 7: Done

✅ You’ve now created your Notion integration, configured permissions, added your integration token to .env.local, and connected it to your database.

Next, we’ll link the correct database to your project using its Database ID.

👉 Next Step