Create a token

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.

Language