How to Use UUIDs with the Notion API

The Notion API uses UUIDs to identify databases, pages, blocks, and other resources. When you work with the Notion API, every request that targets a specific object requires a properly formatted UUID in the path or body. This guide explains how to find, extract, and format these identifiers.

Finding Your Database ID

When you open a Notion database in your browser, the URL in the address bar contains the database ID. However, the ID is often embedded within the URL in a format that is not a valid UUID — it is usually a raw 32-character string without hyphens.

Common Notion URL formats:

https://notion.so/My-Database-7da6eba0d8a2416b80349c6cea7806f0
https://notion.so/7da6eba0d8a2416b80349c6cea7806f0?v=abc123
https://notion.so/workspace?p=7da6eba0d8a2416b80349c6cea7806f0

Converting the Raw ID to UUID Format

The Notion API requires the ID in standard 8-4-4-4-12 UUID format with hyphens. A raw ID like 7da6eba0d8a2416b80349c6cea7806f0 must be formatted as:

7da6eba0-d8a2-416b-8034-9c6cea7806f0

This is exactly what our Notion UUID Converter does — paste any Notion URL and get the properly formatted UUID instantly.

Using the UUID in API Requests

Once you have the formatted UUID, you can use it in your Notion API calls. For example, to query a database:

curl -X POST 'https://api.notion.com/v1/databases/7da6eba0-d8a2-416b-8034-9c6cea7806f0/query' \
  -H 'Authorization: Bearer YOUR_INTEGRATION_TOKEN' \
  -H 'Notion-Version: 2022-06-28' \
  -H 'Content-Type: application/json'

Database ID vs Integration Token

It is important to understand the difference between:

Database ID — The UUID that identifies a specific database or page. This is what our tool extracts and formats. It is public and not a secret.
Integration Token — Your secret API key that starts with secret_ or ntn_. This must be kept private and never shared in client-side code.

Privacy and Security

When using our Notion UUID Converter, all processing happens entirely in your browser. Your Notion URLs and database IDs are never sent to any server. This is especially important because Notion URLs may contain information about your workspace and database names.

UUID Beautifier