Creates an access token that a third-party service can use to authenticate with Notion.


For step-by-step instructions on how to use this endpoint to create a public integration, check out the Authorization guide. To walkthrough how to create tokens for Link Previews, refer to the Link Previews guide.


Redirect URI requirements for public integrations

The redirect_uri is a required field in the request body for this endpoint if:

In most cases, the redirect_uri field is required.

This field is not allowed in the request body if:

  • there is one redirect_uri included in the integration’s settings under OAuth Domain & URIs, and the redirect_uri query parameter was not included in the Authorization URL.

Learn more in the public integration section of 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.