OAuth

Exchange an authorization code for an access and refresh token

Changed on
post/v1/oauth/token

Request

  • Base URL
    https://api.notion.com
  • URL
    https://api.notion.com/v1/oauth/token
  • Auth
    HTTP basic

Headers

Notion-Version'2026-03-11' required

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

Request body

OR

Response

access_tokenstring required
token_type'bearer' required
refresh_tokenstring nullable required
bot_idstring uuid required
workspace_iconstring nullable required
workspace_namestring nullable required
workspace_idstring uuid required
duplicated_template_idstring uuid nullable required
request_idstring uuid

Changes