Comment on page


Notion is a connected workspace, with features for knowledge management, project management, and collaboration.

Configuring the Internal Notion Integration

Creating an Internal Integration in Notion

  1. 1.
    On Notion’s My Integrations screen, click New Integration
  1. 2.
    Choose the workspace and provide a name for the integration:
  2. 3.
    Copy the Internal Integration Secret. You will provide this secret to PixieBrix in the next step.

Configuring a Notion Integration in PixieBrix

To set up a cloud integration that your team can access, head to the Admin Console. (If you'd rather set up something locally, use the Extension Console. Learn more about Configuring Integrations.)
  1. 1.
    From the Integrations section in the Admin or Extension Console, click the + Add Integration button in the top right corner.
    Search for and select the Hunter integration.
  2. 2.
    Configure the integration with a label and the token from Notion
  1. 3.
    Click Save, and your integration will be ready for use in any Hunter mods.

Connecting the Integration to Notion Pages/Databases

To provide your Notion Integration access to pages/databases in your Notion workspace, you must add it as a connection.
  1. 1.
    Click the 3-dot menu for the page
  2. 2.
    Connections > Add connections
  3. 3.
    Search for your integration
  4. 4.
    Confirm access for your configuration

Calling the Notion API from PixieBrix

Calling a Notion API with the HTTP Request Brick

  1. 1.
    Add the HTTP Request Brick to your mod
  2. 2.
    Configure the brick:
    1. 1.
      URL: the URL of the endpoint. The URL can be absolute or relative
    2. 2.
      Integration Configuration: your configured Notion integration
    3. 3.
      Method: the HTTP method, see the documentation for the API you are calling
    4. 4.
      Headers: Notion-Version: the Notion API version for the call, e.g., 2022-06-28
    5. 5.
      JSON Data: the data for the request. See the documentation for the API you are calling