> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://notion.ferndocs.com/authentication/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://notion.ferndocs.com/_mcp/server.

# Authentication

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 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
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 a [Notion SDK](https://notionapi.readme.io/reference/intro#code-samples--sdks), a bearer token can be passed once to initialize a `Client` and the client can be used to send multiple authenticated requests.

**`Notion SDK for JS`**

```JavaScript Notion SDK for JS
const { Client } = require('@notionhq/client');

const client = new Client({ auth: process.env.NOTION_ACCESS_TOKEN });
```

Learn more in the [Authorization guide](/docs/authorization) .


## API Docs

- Authentication [Create a token](https://notion.ferndocs.com/authentication/create-a-token.md)
- Authentication [Introspect token](https://notion.ferndocs.com/authentication/introspect-token.md)
- Authentication [Revoke token](https://notion.ferndocs.com/authentication/revoke-token.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://notion.ferndocs.com/openapi.json)
- [OpenAPI YAML](https://notion.ferndocs.com/openapi.yaml)