Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.notion.com/llms.txt

Use this file to discover all available pages before exploring further.

Requests use the HTTP Authorization header to both authenticate and authorize operations. The Notion API accepts bearer tokens in this header. Bearer tokens are provided to you when you create a connection. If you’re creating a public OAuth connection, the connection also receives bearer tokens each time a user completes the OAuth flow. 
curl 'https://api.notion.com/v1/users' \
  -H 'Authorization: Bearer '"$NOTION_ACCESS_TOKEN"'' \
  -H "Notion-Version: 2026-03-11"
Inside Notion, users will see updates made by connections attributed to a bot. The bot’s name and avatar are controlled in the connection settings. Using the Notion SDK for JavaScript, a bearer token can be passed once to initialize a Client and the client can be used to send multiple authenticated requests. 
const { Client } = require('@notionhq/client');

const client = new Client({ auth: process.env.NOTION_ACCESS_TOKEN });
Learn more in the Authorization guide.