I’m working with the free tier of Notion and I built a custom integration through their developer portal. The integration is set up for the right workspace but I’m having trouble connecting it to a specific page within that workspace.
I found some documentation that mentioned I should be able to add my integration through the page’s invite feature. When I try to use the invite button on my page, I don’t see my integration listed as an option. There’s no dropdown menu or selection interface appearing like I expected.
I’m wondering if this functionality requires a premium subscription or if there’s another way to establish this connection. Has anyone else run into this issue with connecting custom integrations to pages?
yeah, this got me too when i started. don’t look in the invite section - that’s not where it is. go to your page, hit the three dots in the top right, then find ‘connections’ or ‘add connections’. your custom integration will show up there, but you’ve got to set it up in workspace settings first.
It seems you’re dealing with a common stumbling block when first integrating with Notion. The key detail that can easily be overlooked is that simply installing the integration at the workspace level doesn’t automatically grant it access to specific pages. You’ll need to go to the individual page, click the share button, and then search for your integration to grant it access. Make sure there are no delays in loading—sometimes it takes a moment for the integration to appear. Also, verify that your integration has the necessary permissions for full content access, as insufficient permissions might prevent it from showing up as an option. Fortunately, this can all be done on the free tier, so an upgrade isn’t required.
It seems like you’re encountering a common issue related to permission settings rather than a subscription tier. When setting up your integration, ensure you have selected the appropriate permissions for accessing pages, specifically read and write access. After confirming this, navigate to your page settings to manually add the integration through the connections menu. There are instances where the integration might not appear in the invite dropdown if the OAuth flow wasn’t correctly completed. Regenerating your integration token and verifying the workspace ID used in your API calls can also help resolve such issues. I’ve faced similar challenges, and it’s often due to incomplete setup.
don’t mix up the share button with connections - I made this mistake constantly. I’d hit share, type my integration name, and get nothing. you’ve got to set up the connection through the page menu first. after that, your integration shows up when you share.
Had this exact problem a few months ago and wasted hours debugging my API code when it was just a Notion setup issue. There’s a two-step process that’s not obvious at first. First, check your integration’s capabilities in the developer portal - you need the content capabilities for reading/writing pages, not just basic setup. Second, you have to manually share each page with your integration. Go to page settings and find the share or connections option. Your integration can’t access pages automatically even when it’s connected to the workspace. Works fine on the free tier too, so no need to upgrade.
The invite feature works fine on the free tier. I had this same issue - turns out I hadn’t installed the integration at the workspace level first. You can’t connect it to individual pages until you install it through workspace settings in the ‘My connections’ or ‘Integrations’ section. After that, don’t use the regular invite button. Instead, click the three dots on your page and select ‘Add connections’ - that’s where the integration will show up. The invite button’s just for adding people. Once you connect it this way, your API calls should work with that page ID.
Custom integrations work fine with free Notion accounts - that’s not your problem. You’re probably missing Notion’s two-step setup. First, install your integration at the workspace level through admin settings. Second, connect it to specific pages through the page’s connection settings (not the invite button). I bet your integration exists in the developer portal but isn’t actually installed in your workspace yet. Check your workspace settings for an integrations or connections tab - that’s where you’ll install it. Skip this step and it won’t show up anywhere in your pages. Once you’ve got that sorted, connecting pages is easy through the three dots menu like everyone else mentioned.