GPT Action Library: Notion

Introduction

This page provides an instruction & guide for developers building a GPT Action for a specific application. Before you proceed, make sure to first familiarize yourself with the following information:

• Introduction to GPT Actions
• Introduction to GPT Actions Library
• Example of Buliding a GPT Action from Scratch

This particular GPT Action provides an overview of how to connect to Notion. This Action takes a user’s question, scans the relevant Notion pages using Notions search functionality, and then returns information on the matching pages.

Value + Example Business Use Cases

Value: Users can now harness ChatGPT’s natural language capabilities to directly connect to, query, and synthesize their knowledge within Notion. Administrators can explicitly share pages with the integration to manage access.

Example Use Cases:

• A new employee seeks quick how-to information on setting up a new system
• A support agent needs to quickly retrieve information from Notion without reading the entire document
• Users want to synthesize information and create summaries or transformations for use in other aspects of their work

Application Information

Application Key Links

Check out these links from the application before you get started:

• Application Website: https://www.notion.so/
• Application API Documentation: https://developers.notion.com/reference/intro
• Notion Authorization Approach: https://developers.notion.com/docs/authorization
  • NOTE: Notion only allows OAuth with "Public Integrations." Refer to the linked documentation to determine what is best suited for your needs

Application Prerequisites

Before you get started, make sure you go through the following steps in your application environment:

• Set up a notion workspace with populated pages
• Sharing pages through notion works best with specific Wikis. Consider organizing your knowledge base into a wiki or set of wikis

ChatGPT Steps

Custom GPT Instructions

Once you've created a Custom GPT, copy the text below in the Instructions panel. Have questions? Check out Getting Started Example to see how this step works in more detail.

OpenAPI Schema

Once you've created a Custom GPT, copy the text below in the Actions panel. Have questions? Check out Getting Started Example to see how this step works in more detail.

Authentication Instructions

Below are instructions on setting up authentication with this 3rd party application.

Pre-Action Steps

Before you set up authentication in ChatGPT, please take the following steps in the Notion.

1. Go to the Notion Settings Page for your workspace
2. Navigate to My Connections > Develop or Manage Integrations
3. Create new Integration marked as Internal
4. Locate your integration and find the API Key labeled: Internal Integration Secret. This is the bearer token for this integration.

NOTE! You need to share specific pages, databases, or wikis with the integration in order to access them in ChatGPT. Do this by selecting the ... button on the upper right of a page and select the appropriate connection.

NOTE! Notion allows integrations to leverage OAuth if they are marked as "Public." Review Notion's Auth Documentation to determine what integration path is best for your needs.

In ChatGPT

In ChatGPT, click on "Authentication" and choose "API Key". Enter in the information below.

• API Key: Use Internal Integration Secret from steps above
• Auth Type: Bearer

FAQ & Troubleshooting

• Search returns nothing If you don't see any pages returned when running a search, double check that you've shared relevant pages with the application from Notion

Are there integrations that you’d like us to prioritize? Are there errors in our integrations? File a PR or issue in our github, and we’ll take a look.