Troubleshooting Notion Database Connection Issues with NoteForms
If you're experiencing connection issues with your Notion database on NoteForms, follow this comprehensive guide to identify and resolve the problem.
Accessing the Troubleshooting Page
To start troubleshooting:
- Visit the Troubleshooting Page: Go to NoteForms Troubleshooting.
- Select the Workspace: In the top navigation bar, choose the appropriate workspace linked to the form experiencing issues.
- Start Troubleshooting: Click the "Start Troubleshooting" button to view a detailed table of forms, their associated databases, and the connection status.
The table will display the following columns:
- Form Id: Unique identifier for the form.
- Form: A link to the form.
- Database: A link to the Notion database.
- Creator: The email of the form creator.
- Status: Current connection status.
- Error: The specific error encountered, if any.
Identifying the Problem
Check the Status and Error columns for any issues. Common errors include:
- Expired/Revoked
- Resource Not Found
Resolving Common Issues
1. Expired/Revoked Connection
This error indicates that the Notion connection granted by the form creator has expired or been revoked.
Resolution:
- If the form creator is still part of your organization:
- The creator must log in to NoteForms.
- Navigate to the Workspace Settings Page.
- Click "Connect a workspace" and re-connect the Notion workspace. Do not remove the workspace.
- Follow this detailed guide to ensure proper connection.
- If the form creator is no longer part of your organization:
- Take ownership of the form:
- Find the form in the list of forms and click on it.
- Open the share page and access Advanced Options by clicking the […] button.
- Select the "Take Ownership" option.
- After taking ownership, click the "Submissions" button on the share page to open the associated Notion database.
- Ensure the database is properly shared with the NoteForms integration. Follow this sharing guide.
Important notes
- If troubleshooting shows Expired/Revoked, re-connect the workspace from Workspace Settings.
This error suggests that the connection is valid, but NoteForms cannot access the form’s Notion database. Common causes include:
- The database is no longer shared with the integration.
- The database was moved to a location not shared with the integration.
- Pages used by Relation properties are not shared with the NoteForms integration.
Resolution:
- Re-share the database with the integration. Follow this step-by-step guide to ensure proper sharing.
- Confirm the database’s location in the workspace is accessible to the integration.
- If your form uses Relation fields, make sure the related pages are also shared with NoteForms. In Notion, go to Workspace settings → Connections and share the required pages with the NoteForms integration. If needed, use Notion’s bulk sharing options.
- After updating sharing permissions, submit the form again and check the Troubleshooting page for any remaining access errors.
Additional Resources
Resolution:
For further assistance, feel free to contact NoteForms support.
If the form editor shows a technical error
If you see an error while opening or editing a form, first identify the last action performed before the error appeared. This is especially useful when the issue happens after adding a block, dragging a field, opening the editor, or editing a published form.
If the form is linked to Notion and the editor cannot load or shows an unexpected error, disconnect and reconnect the NoteForms integration for the connected Notion database, then make sure the database is shared correctly with the integration:
If the issue continues, share the form URL and a screenshot or video showing the error.
By following this guide, you should be able to resolve most database connection issues and ensure your forms work seamlessly with Notion.
If the above steps do not resolve your issue, consult the following resources:
For further assistance, feel free to contact NoteForms support.
By following this guide, you should be able to resolve most database connection issues and ensure your forms work seamlessly with Notion.
Updated on: 27/03/2026
Thank you!