How to create an OAuth app in Notion

Before you start, you'll need:

A Notion account (you can sign up here)
A workspace where you have admin permissions
Your OAuth redirect URI: https://unify.apideck.com/vault/callback

Register a new Notion integration application

Go to the Notion Developers page and log in if necessary.
Click on the "New integration" button.
Fill out the basic information for your integration:
- Name your integration (this will be visible to users)
- Choose the workspace where you want to create the integration
- Add a logo (optional)
Click "Submit" to create your integration.
On the next page, you'll see your integration's details. Here you can find your Client ID and Client Secret.
In the "Capabilities" section, enable "Read content" and "Update content" (or any other capabilities your integration needs).
In the "OAuth Domain & URIs" section:
- Add your redirect URI:
```
https://unify.apideck.com/vault/callback
```
Save your changes.

Make sure to securely store your Client ID and Client Secret. You'll need these to authenticate your requests to the Notion API.

Do your first API call

To test your integration:

Connect your Notion account through Apideck's Vault with a test session.
To test the access token, make a call to the
```
List all users
```
endpoint using the Proxy API:

curl --location --request GET 'https://unify.apideck.com/proxy' \
--header 'x-apideck-consumer-id: test-consumer' \
--header 'x-apideck-app-id: {APIDECK_APP_ID}' \
--header 'x-apideck-service-id: notion' \
--header 'x-apideck-downstream-url: https://api.notion.com/v1/users' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {APIDECK_API_KEY}' \
--header 'Notion-Version: 2022-06-28

Start building with notion API

Learn what else you can build with the Notion API.

Interested in a personalized demo? Let us know.