Troubleshooting Errors
This guide helps you resolve common errors when using Note API Connector.
❌ Error: "Integration doesn’t have access to this Notion page"
Issue
You may see this error if Note API Connector doesn’t have permission to access your Notion page.
Solution
1️⃣ Open the Notion page you are trying to connect.
2️⃣ Click the three-dot menu (•••) in the top-right corner.
3️⃣ Select Connections.
4️⃣ Click Note API Connector and confirm the access.
❌ Error: "API response is not in JSON or XML format. It appears to be HTML."
Issue
This error occurs when the API you are connecting to returns data in HTML format instead of XML or JSON.
Solution
✅ Check the API URL – Ensure the endpoint returns JSON or XML, not an HTML webpage.
✅ Verify API request headers – Some APIs require the Accept: application/json header.
✅ Check authentication – Some APIs return an HTML login page if authentication fails.
Example of an incorrect response:
❌ Error: "This database is at the top level of your Notion workspace and can’t be used for writing data via the Notion API."
Issue
You may see this error when attempting to write data to a Notion database that is not nested inside a page — also known as a top-level database.
This is due to a limitation in the Notion API. Even if the integration has access to your workspace, Notion currently does not support inserting data into databases that are not parented by a page. This can result in silent failures or this specific error message.
Solution
To resolve this issue, move your database into a page that’s shared with the integration:
1️⃣ Open or create a Notion page where your database should live.
2️⃣ Click "+" or use the slash command / to add a new database inline or as a full page — or move an existing database into that page.
3️⃣ Ensure the parent page is shared with Note API Connector (via the Connections menu).
Need More Help?
If you’re still experiencing issues, contact Note API Connector Support: