Troubleshoot the Notion connector
This feature is in Beta. Workspace admins can control access to this feature from the Previews page by opting into the Notion connector preview. See Manage Databricks previews.
This page describes common errors you might encounter with the managed Notion connector and how to resolve them.
For general troubleshooting guidance that applies to all managed ingestion pipelines, see Troubleshoot managed ingestion pipelines.
Connection creation fails with a 401 Unauthorized or invalid_client error
Cause: The Client ID or Client Secret does not match your Notion public integration, or the integration's redirect URI does not match your Databricks workspace callback URL.
Solution:
Verify that the Client ID and Client Secret match your Notion public integration, and that the integration's redirect URI exactly matches your Databricks workspace callback URL (https://<your-workspace-domain>/login/oauth/http.html). See Configure authentication to Notion.
A page or database is missing from the ingested data
Cause: The page or data source was not shared with the integration in the Notion page picker during connection setup. The connector can only access content you explicitly share.
Solution:
Confirm that the page or data source was shared with the integration in the Notion page picker. To share additional content, edit the shared selection in Notion, then re-run the pipeline. See Create a Notion connection.
Pipeline is rate limited
Cause: The pipeline exceeded the Notion API rate limit. Notion returns HTTP 429 and reports the wait interval in the Retry-After response header.
Solution:
The connector automatically waits and retries when Notion rate limits a request. If rate limiting persists, reduce how frequently the pipeline runs. See Ingest data from Notion.
Pipeline fails to authenticate
Cause: The connection credentials are no longer valid, or the OAuth client secret was rotated in Notion.
Solution:
The connector refreshes the access token automatically. If authentication still fails, verify the Client ID and Client Secret on the connection. To update rotated credentials, see Create a Notion connection.