Skip to main content
POST
/
v1
/
oauth
/
token
TypeScript SDK
import { Client } from "@notionhq/client"

const notion = new Client()

const response = await notion.oauth.token({
  client_id: process.env.OAUTH_CLIENT_ID,
  client_secret: process.env.OAUTH_CLIENT_SECRET,
  grant_type: "authorization_code",
  code: "abc123-authorization-code",
  redirect_uri: "https://example.com/callback"
})
{
  "access_token": "<string>",
  "token_type": "<string>",
  "refresh_token": "<string>",
  "bot_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "workspace_icon": "<string>",
  "workspace_name": "<string>",
  "workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "owner": {
    "type": "<string>",
    "user": {
      "type": "<string>",
      "person": {
        "email": "<string>"
      },
      "name": "<string>",
      "avatar_url": "<string>",
      "id": "<string>",
      "object": "<string>"
    }
  },
  "duplicated_template_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

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.

For step-by-step instructions on how to use this endpoint to refresh an access token, check out the Authorization guide.
Note: Each Public API endpoint can return several possible error codes. To see a full description of each type of error code, see the Error codes section of the Status codes documentation.

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Headers

​
Notion-Version
enum<string>
required

The API version to use for this request. The latest version is 2026-03-11.

Available options:
2026-03-11

Body

application/json
​
grant_type
string
required
Allowed value: "authorization_code"
​
code
string
required
​
redirect_uri
string
​
external_account
object

Response

​
access_token
string
required
​
token_type
string
required
Allowed value: "bearer"
​
refresh_token
string | null
required
​
bot_id
string<uuid>
required
​
workspace_icon
string | null
required
​
workspace_name
string | null
required
​
workspace_id
string<uuid>
required
​
owner
User · object
required
​
duplicated_template_id
string<uuid> | null
required
​
request_id
string<uuid>