How to Push Content to Notion from Python

How to Push Content to Notion from Python: A Step-by-Step Guide

by

Notion has become a powerful productivity tool, and integrating it with Python can automate workflows, streamline data management, and enhance productivity. If you’re looking to push content to Notion programmatically, Python provides an excellent way to do so using the official Notion API.

In this article, we’ll walk through the entire process—from setting up a Notion integration to writing Python code that pushes data into your Notion workspace. So let’s get started.

Prerequisites

Before we begin, ensure you have the following:

  1. A Notion account (free or paid).
  2. Python installed on your machine (version 3.6 or higher recommended).
  3. Basic knowledge of Python and REST APIs.

Step 1: Set Up a Notion Integration

To interact with Notion via API, you need to create an integration. For that, follow below steps.

  1. Go to Notion’s Integrations Page.
  2. Click “New integration”.
  3. Provide a name (e.g., “Python Notion Integration”).
  4. Select the workspace where you want to use this integration.
  5. Click Submit.

After creation, you’ll see an “Internal Integration Token”—copy this token; we’ll use it later.

Step 2: Connect the Integration to a Notion Page

Your integration needs permission to modify a Notion page.

  1. Open a Notion page (or create a new one).
  2. Click the three-dot menu (⋯) → “Add connections”.
  3. Search for your integration name and select it.

Now, your Python script can interact with this page.

Step 3: Install Required Python Libraries

We’ll use the notion-client library, an official Python SDK for Notion.

Run this command in your terminal:

pip install notion-client

Step 4: Get the Notion Page ID

Every Notion page has a unique ID. To find it:

  1. Open the page in your browser.
  2. The URL will look like:
https://www.notion.so/yourworkspace/Page-Title-1234567890abcdef1234567890abcdef

Copy the last part (1234567890abcdef1234567890abcdef). This is your page ID.

Step 5: Write Python Code to Push Content to Notion

Now, let’s write a script that adds content to Notion.

Example 1: Adding a Simple Text Block

from notion_client import Client

# Initialize the client with your integration token
notion = Client(auth="your_integration_token_here")

# Define the page ID where you want to add content
page_id = "your_page_id_here"

# Add a new paragraph block
new_block = {
    "children": [
        {
            "object": "block",
            "type": "paragraph",
            "paragraph": {
                "rich_text": [{
                    "type": "text",
                    "text": {"content": "Hello from Python!"}
                }]
            }
        }
    ]
}

# Update the page
notion.blocks.children.append(block_id=page_id, children=new_block["children"])

print("Content added successfully!")

Example 2: Adding a To-Do List Item

new_todo = {
    "children": [
        {
            "object": "block",
            "type": "to_do",
            "to_do": {
                "rich_text": [{
                    "type": "text",
                    "text": {"content": "Complete Python-Notion integration"}
                }],
                "checked": False
            }
        }
    ]
}

notion.blocks.children.append(block_id=page_id, children=new_todo["children"])

Example 3: Inserting a Database Row

database_id = "your_database_id_here"

new_row = {
    "Name": {"title": [{"text": {"content": "New Task"}}]},
    "Status": {"select": {"name": "Not Started"}},
    "Due": {"date": {"start": "2023-12-31"}}
}

notion.pages.create(parent={"database_id": database_id}, properties=new_row)

Step 6: Handling Errors and Troubleshooting

  • “Invalid API token”: Ensure your integration token is correct.
  • “Permission error”: Make sure the integration is connected to the page.
  • “Page not found”: Verify the page ID.

Use try-except blocks for better error handling:

try:
    notion.blocks.children.append(block_id=page_id, children=new_block["children"])
except Exception as e:
    print(f"Error: {e}")

Step 7: Automating Regular Updates

You can schedule Python scripts (using cron or Task Scheduler) to push data daily, such as:

  • News updates
  • Task reminders
  • Database syncs

Example:

import schedule
import time

def update_notion():
    notion.blocks.children.append(block_id=page_id, children=new_block["children"])

schedule.every().day.at("09:00").do(update_notion)

while True:
    schedule.run_pending()
    time.sleep(1)

Conclusion

Pushing content to Notion from Python opens up endless automation possibilities. Whether you’re managing tasks, logging data, or syncing external apps, the Notion API makes it seamless.

I hope you will find this article useful.

Leave a Comment