Skip to main content
POST
TypeScript SDK
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>