Skip to main content

Error Messages

This page explains common error messages in Note API Connector and how to resolve them.

Error: "Integration doesn’t have access to this Notion page"​

Why this happens Note API Connector doesn’t have permission to access your Notion page.

Notion Access Error

How to fix it

  1. Open the Notion page you want to connect.
  2. Click the three-dot menu (•••) in the top-right corner.
  3. Select Connections.
  4. Click Note API Connector and confirm access.
Granting Access
tip

You can also log out and log back in. You’ll be prompted to re-grant access to your Notion page.

Error: "API response is not in JSON or XML format. It appears to be HTML."​

Why this happens The API you’re connecting to is returning HTML instead of JSON or XML.

How to fix it

tip
  • Check the API URL — make sure the endpoint returns JSON or XML, not a webpage.
  • Verify API headers — some APIs require Accept: application/json.
  • Check authentication — an HTML login page may appear if credentials are missing.

Example of an incorrect response:

HTML Response Error

Error: "API responded with an empty array / object / string"​

Why this happens The API request was successful, but it returned no usable data.

Examples of empty responses

  • [] → empty array
  • {} → empty object
  • { "data": [] } → empty nested array
  • "" → empty string

Common causes

  • Requesting a page of results that doesn’t exist
  • Filters returned no results
  • Missing required parameters (e.g. date, id, status)
  • Looking in the wrong place

How to fix it

tip
  • Double-check the API endpoint and query parameters
  • Remove filters and try again
  • Paste the API URL into your browser to check the raw response (for public GET endpoints)

Need More Help?​

If you’re still experiencing issues, contact Note API Connector Support:

Leave a Comment