Important: You need a Notion workspace with a database properly configured for blog posts to use this integration.

Create a Notion Integration

First, you need to create an internal integration in Notion to get an API token.

1. Go to Notion Integrations

2. Click "Create new integration"

3. Choose "Internal integration"

4. Enter a name for your integration (e.g., "Blog Generator")

5. Select your workspace

6. Upload a logo (optional)

7. Click "Submit"

8. Copy the "Internal Integration Token" - you'll need this later

Keep your integration token secure and never share it publicly. It provides access to your Notion workspace.

Create a Blog Database

You need a properly structured database in Notion to store your blog posts.

1. In your Notion workspace, create a new page

2. Add a database (full page database recommended)

3. Name your database (e.g., "Blog Posts")

4. Configure the following properties (columns):

• Title (Title type) - for the blog post title

• Content (Text type) - for the blog post content

• Status (Select type) - with options like "Draft", "Published", "Review"

• Published Date (Date type) - for the publication date

• Meta Description (Text type) - for SEO description

• Featured Image (Files & media type) - for the main image

• Slug (Text type) - for the URL slug

You can add additional properties as needed, but these are the minimum required for the integration to work properly.

Share Database with Integration

Your integration needs permission to access your database.

1. Open your blog database page in Notion

2. Click the "Share" button in the top right

3. Click "Invite" and search for your integration name

4. Select your integration from the dropdown

5. Make sure it has "Full access" permissions

6. Click "Invite"

Tip: You can also share the entire workspace with your integration if you want it to access multiple databases.

Get Database ID

You need to find your database ID to configure the integration.

1. Open your blog database in Notion

2. Copy the URL from your browser's address bar

3. The Database ID is the 32-character string in the URL

4. Example URL: notion.so/workspace/DATABASE_ID?v=...

5. The Database ID looks like: a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6

Alternative method:

You can also right-click on your database, select "Copy link", and extract the ID from the copied URL.

Configure Integration in Blog Generator

Now let's configure the integration in your Blog Generator workspace.

1. Navigate to Workspace Settings → Integrations

2. Find the "Notion" integration and click "Configure"

3. Enter the following information:

   
   

   1. Integration Token: The token you copied from step

   2. Database ID: The database ID from step

4. Click "Test Connection" to verify the setup

5. If successful, click "Save" to complete the configuration

Publishing Articles

You're all set! Here's how to publish articles to your Notion database.

1. Go to your Articles page

2. Select the article you want to publish

3. Click the "Publish" button

4. Choose "Notion" from the publishing options

5. Configure the status and other settings

6. Click "Publish to Notion"

Tip: Use the Calendar page to schedule articles for automatic publishing to Notion at specific times.

Troubleshooting

"Unauthorized" error

Check that your Integration Token is correct and that you've shared the database with your integration. Make sure the integration has full access permissions.

"Database not found" error

Verify that your Database ID is correct and that the database exists. Ensure the integration has been invited to access the database.

"Property not found" error

Make sure your database has all the required properties (Title, Content, Status, etc.) with the correct types as specified in step 2.