Skip to main content

Authorization

Follow this guide to create a new Notion API credential that will allow Nexla to authenticate to and exchange data with your Notion workspace.
notion_api_auth.png

Notion Api

Prerequisites​

Before creating a Notion API credential, you need to obtain your API key (integration token) from your Notion workspace. Notion uses API key authentication for all API requests, with the API key sent in the Authorization header with the Bearer prefix.

To obtain your Notion API key, follow these steps:

  1. Sign in to your Notion workspace using your administrator credentials.

  2. Navigate to Settings & Members in your Notion workspace.

  3. Click on Connections or Integrations in the left menu.

  4. Click New integration or + New integration to create a new integration.

  5. Configure your integration settings:

    • Enter a name for the integration (e.g., "Nexla Integration")
    • Select the workspace or pages you want the integration to have access to
    • Review and select the capabilities or permissions for the integration (e.g., Read content, Update content, Insert content)

  6. Click Submit or Create integration to create the integration.

  7. Once the integration is created, you will see the Internal Integration Token. Copy this token immediately, as it may not be accessible again after you navigate away from the page.

  8. Store the API key securely, as you will need it to configure your Nexla credential. The API key is sensitive information and should be kept confidential.

The API key (integration token) is sent in the Authorization header with the Bearer prefix (e.g., Authorization: Bearer {api_key}) for all API requests to the Notion API. The API key authenticates your requests and grants access to Notion resources based on the integration's permissions and the pages/workspaces it has access to. If your API key is compromised, you should immediately revoke it in your Notion workspace settings and generate a new one. For detailed information about obtaining API keys, API authentication, and available endpoints, refer to the Notion API documentation.

Create a Notion API Credential​

  • To create a new Notion API credential, after selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

New Credential Overlay – Notion API

NotionCred.png

Credential Name & Description​

  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

    Resource descriptions are recommended but are not required. They should be used provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

API Key Authentication​

Notion uses API key authentication for all API requests. The API key (integration token) is sent in the Authorization header with the Bearer prefix to authenticate API requests to the Notion API.

  1. Enter your Notion API key in the API Key Value field. This is the integration token you obtained from your Notion workspace settings (Settings & Members > Connections > Integrations). The API key is sent in the Authorization: Bearer {api_key} header for all API requests to the Notion API. The API key is sensitive information and must be kept confidential.

    Your Notion API key (integration token) can be found in your Notion workspace settings under Settings & Members > Connections > Integrations. After creating a new integration, you will see the Internal Integration Token which serves as your API key. The API key is sent in the Authorization: Bearer {api_key} header for all API requests to the Notion API.

    If your API key is compromised, you should immediately revoke it in your Notion workspace settings and generate a new one. The API key provides access to your Notion workspace data based on the integration's permissions and should be treated as sensitive information. Keep your API key secure and do not share it publicly.

    For detailed information about obtaining API keys, API authentication, and available endpoints, see the Notion API documentation.

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation and can be selected for use with a new data source or destination.