Authentication
Requests use the HTTPAuthorization 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 an integration. If you're creating a public OAuth integration, the integration 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: 2022-06-28"Inside Notion, users will see updates made by integrations attributed to a bot. The bot's name and avatar are controlled in the integration settings.
Using aNotion SDK, a bearer token can be passed once to initialize aClient 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 theAuthorization guide .