# How to create an OAuth app in Notion

## Before you start, you'll need:

- A Notion account ([you can sign up here](https://www.notion.so/signup))
- A workspace where you have admin permissions
- Your OAuth redirect URI: __https://unify.apideck.com/vault/callback__

## Register a new Notion integration application

1. Go to the [Notion Developers](https://www.notion.so/my-integrations) page and log in if necessary.
2. Click on the "New integration" button.
3. 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)
4. Click "Submit" to create your integration.
5. On the next page, you'll see your integration's details. Here you can find your **Client ID** and **Client Secret**.
6. In the "Capabilities" section, enable "Read content" and "Update content" (or any other capabilities your integration needs).
7. In the "OAuth Domain & URIs" section:
   - Add your redirect URI: `https://unify.apideck.com/vault/callback`
8. 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:

1. Connect your Notion account through [Apideck's Vault](https://platform.apideck.com/vault) with a test session.
2. To test the access token, make a call to the [`List all users`](https://developers.notion.com/reference/get-users) endpoint using the [Proxy API](https://developers.apideck.com/apis/proxy/reference):

```
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](https://developers.notion.com/).

Interested in a personalized demo? [Let us know](https://www.apideck.com/demo-request?from=guide).