Struggling to add multiple tags when creating Notion pages via API

Other Questions Notion
1

Hey everyone,

I’m having trouble figuring out how to add multiple tags when creating a page using the Notion API. I’ve got single tags working fine, but multiple tags are giving me headaches.

Here’s what I’ve tried:

page_data = {
    "parent": {"database_id": "db123"},
    "properties": {
        "Title": {
            "title": [{"text": {"content": "My New Page"}}]
        },
        "Tags": {
            "multi_select": {
                "options": [
                    {"name": "Important", "color": "blue"},
                    {"name": "Urgent", "color": "red"}
                ]
            }
        }
    }
}

But I keep getting a validation error. Any idea what I’m doing wrong? Is there a working example someone can share? Thanks in advance!

2

hey finn, i had the same problem. try this:

page_data = {
    "parent": {"database_id": "db123"},
    "properties": {
        "Title": {"title": [{"text": {"content": "My New Page"}}]},
        "Tags": {"multi_select": [{"name": "Important"}, {"name": "Urgent"}]}
    }
}

this should work. make sure ur tags match whats in ur database exactly. good luck!

3

I encountered a similar issue when working with the Notion API. The key is to structure the ‘multi_select’ property correctly. Here’s what worked for me:

page_data = {
    "parent": {"database_id": "db123"},
    "properties": {
        "Title": {
            "title": [{"text": {"content": "My New Page"}}]
        },
        "Tags": {
            "multi_select": [
                {"name": "Important"},
                {"name": "Urgent"}
            ]
        }
    }
}

This format should resolve your validation error. Remember, the tag names must exactly match existing tags in your database. Also, ensure you’re using the correct API version and have the necessary permissions set up. If you’re still facing issues, double-check your API token and database ID.

4

I’ve wrestled with this issue before, and I can share what worked for me. The problem lies in how you’re structuring the ‘multi_select’ property. Instead of using ‘options’, you need to use an array of objects directly. Here’s the corrected version:

page_data = {
    "parent": {"database_id": "db123"},
    "properties": {
        "Title": {
            "title": [{"text": {"content": "My New Page"}}]
        },
        "Tags": {
            "multi_select": [
                {"name": "Important"},
                {"name": "Urgent"}
            ]
        }
    }
}

Notice that we removed ‘options’ and directly provided an array of tag objects. Also, you don’t need to specify the color in the API call - Notion will use the predefined colors for these tags if they already exist in your database.

This structure should work for adding multiple tags. Just make sure the tag names match exactly with existing tags in your Notion database. If you’re still running into issues, double-check your API permissions and make sure you’re using the latest version of the Notion API.