{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-agen-for-work/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["Notification","LightboxImage"]},"type":"markdown"},"seo":{"title":"Notion integration","siteUrl":"https://developers.frontegg.com/","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"notion-integration","__idx":0},"children":["Notion integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Integrating Notion with Frontegg allows your application to authenticate users via OAuth 2.0 and interact with their Notion workspaces — reading pages, creating content, querying databases, and posting comments on their behalf."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Prerequisites","type":"attention"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A Notion account"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Access to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.notion.so/my-integrations"},"children":["Notion integrations portal"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"connect-notion","__idx":1},"children":["Connect Notion"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-1-open-the-notion-integrations-portal","__idx":2},"children":["Step 1: Open the Notion integrations portal"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.notion.so/my-integrations"},"children":["notion.so/my-integrations"]},". Sign in with your Notion account if prompted, then click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create a new integration"]},"."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/notion-1.1cf30295ff0ce24c30b7e1ee6a61d9d708e201338c0e0338981394d5b347e0a1.1ce25488.png","alt":"Notion integrations portal"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-2-fill-in-the-integration-details","__idx":3},"children":["Step 2: Fill in the integration details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fill in the following fields:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Integration name"]},": Enter a name for your integration (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Frontegg Integration"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Icon"]},": Upload a square PNG or JPG image (512×512 px recommended)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Associated workspace"]},": Select the workspace where you will test and develop this integration."]}]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/notion-2.ea29d6c90596db43bfd456bae45686e3e1a6b301739c12415393ec6631d84642.1ce25488.png","alt":"Notion new integration form"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-3-configure-redirect-uris","__idx":4},"children":["Step 3: Configure redirect URIs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authorization (OAuth)"]}," section, enter the following redirect URIs one at a time and press Enter after each:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://YOUR_MCP_GATEWAY_URL/integration-callback"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create"]}," to submit the form."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/notion-3.cb6a3a65eac00f9f3c6c9aa4be62f35d9c229cc3670baa93bf2852a09478e7d1.1ce25488.png","alt":"Notion redirect URIs configuration"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-4-integration-created","__idx":5},"children":["Step 4: Integration created"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A confirmation dialog appears. Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Configure integration settings"]}," to proceed to the integration's settings page."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/notion-4.b6219a26340e8ccee7f5fd092e6100f48af8515eeff4f1833bb6ae9dac9fa6e3.1ce25488.png","alt":"Notion integration created dialog"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-5-copy-your-oauth-client-id","__idx":6},"children":["Step 5: Copy your OAuth Client ID"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On the settings page, find the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authorization (OAuth)"]}," section. Your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth Client ID"]}," is displayed there. Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Copy"]}," to copy it for use in the Frontegg portal."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/notion-5.2e70c9b77dcc82f02ccf2fe528389eb206a90607b06a303f4f7d8aa15f54973c.1ce25488.png","alt":"Notion OAuth Client ID"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-6-copy-your-oauth-client-secret","__idx":7},"children":["Step 6: Copy your OAuth Client Secret"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Show"]}," next to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth Client Secret"]},", confirm the prompt, then click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Copy"]}," to save the secret."]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Keep your credentials secure","type":"attention"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Client Secret is shown only once. Store it immediately in a secure location. Never share or commit it to version control."]}]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/notion-6.ff67114d4752dce34ec825cc242c13ff87ce1dc41c3b9be8b692fe6b4682a754.1ce25488.png","alt":"Notion OAuth Client Secret"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-7-configure-capabilities","__idx":8},"children":["Step 7: Configure capabilities"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Scroll down to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Capabilities"]}," section and select the capabilities your integration requires. Notion uses capability-based permissions instead of traditional OAuth scopes — the selected capabilities are shown to users when they authorize your integration."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Capability"},"children":["Capability"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Read content"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read pages, databases, and blocks"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Update content"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Update existing pages and blocks"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Insert content"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create new pages, databases, and blocks"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Read comments"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read comments on blocks and pages"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Insert comments"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create comments on blocks and pages"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Read user information including email addresses"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Access user profile information and email addresses"]}]}]}]}]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/notion-7.164f3c2679291bb063f865295680e353512b997f54bfb68c877f8bfd43c2e4b7.1ce25488.png","alt":"Notion capabilities configuration"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-8-save-the-integration","__idx":9},"children":["Step 8: Save the integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," to apply the capability settings. A confirmation message appears when the changes are saved."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/notion-8.5b6e4504f9cb7f0ba4e046147f44bfde0001e55f65f39398c03dc575d2a0c95f.1ce25488.png","alt":"Notion integration saved"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"configure-the-frontegg-portal","__idx":10},"children":["Configure the Frontegg portal"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once you have your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth Client ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth Client Secret"]},", configure the integration in the Frontegg portal:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Frontegg portal"]}," and navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["[ENVIRONMENT]"]}," → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Integrations"]}," → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Notion"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth Client ID"]}," in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," field and the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth Client Secret"]}," in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]}," field."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the required ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["capabilities"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"additional-resources","__idx":11},"children":["Additional resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.notion.com/docs/authorization"},"children":["Notion OAuth 2.0 documentation"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.notion.so/my-integrations"},"children":["Notion integrations portal"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/agen-for-work/connectors/redirect-url"},"children":["How to get your Redirect URL"]}]}]}]}]},"headings":[{"value":"Notion integration","id":"notion-integration","depth":2},{"value":"Connect Notion","id":"connect-notion","depth":3},{"value":"Step 1: Open the Notion integrations portal","id":"step-1-open-the-notion-integrations-portal","depth":4},{"value":"Step 2: Fill in the integration details","id":"step-2-fill-in-the-integration-details","depth":4},{"value":"Step 3: Configure redirect URIs","id":"step-3-configure-redirect-uris","depth":4},{"value":"Step 4: Integration created","id":"step-4-integration-created","depth":4},{"value":"Step 5: Copy your OAuth Client ID","id":"step-5-copy-your-oauth-client-id","depth":4},{"value":"Step 6: Copy your OAuth Client Secret","id":"step-6-copy-your-oauth-client-secret","depth":4},{"value":"Step 7: Configure capabilities","id":"step-7-configure-capabilities","depth":4},{"value":"Step 8: Save the integration","id":"step-8-save-the-integration","depth":4},{"value":"Configure the Frontegg portal","id":"configure-the-frontegg-portal","depth":3},{"value":"Additional resources","id":"additional-resources","depth":3}],"frontmatter":{"seo":{"title":"Notion integration"}},"lastModified":"2026-05-01T18:45:25.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/agen-for-work/connectors/marketplace/notion","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}