Search Atlas Help Center

🔧 Cloudflare API Token Permissions for Clearview

Open in
View as Markdown Open in ChatGPT Open in Claude
Camilo Aponte

Camilo Aponte

Last updated on Sep 30, 2026

🌐 Overview

Connecting Clearview to your Cloudflare account requires a Cloudflare API token with specific permissions. A common issue customers encounter is searching for a Workers Routes permission that no longer exists in the current Cloudflare dashboard. This article explains exactly which permissions to select and how to create the token correctly using the updated Cloudflare UI.

⚠️ Common Mistake: Workers Routes Permission

Older versions of the Clearview integration guide referenced a Workers Routes permission inside Cloudflare's token creation screen. Cloudflare has since redesigned their token creation interface, and this permission label no longer appears. If you have been searching for it, that is why the setup has been failing. You do not need a Workers Routes permission — follow the steps below to configure the correct permissions.

✅ Required API Token Permissions

When creating your Cloudflare API token for the Clearview integration, you must include the following permissions:

  • Zone — DNS — Edit: Allows Clearview to read and update DNS records on your domain.
  • Zone — Zone — Read: Allows Clearview to identify and access your Cloudflare zone (domain).

These two permissions are sufficient for the integration to function. Do not add unnecessary permissions, as this can cause authorisation errors.

🛠️ How to Create the API Token

  1. Log in to your Cloudflare dashboard at dash.cloudflare.com.
  2. Click your profile icon in the top-right corner and select My Profile.
  3. Navigate to the API Tokens tab on the left sidebar.
  4. Click Create Token.
  5. Scroll down and select Create Custom Token by clicking Get started.
  6. Give your token a recognisable name, such as Clearview Integration.
  7. Under Permissions, add the following two permission rows:
    • Row 1: Select Zone — DNS — Edit
    • Row 2: Click Add more, then select Zone — Zone — Read
  8. Under Zone Resources, set the scope to Include — Specific zone and select the domain you are connecting to Clearview.
  9. Click Continue to summary, review the permissions, then click Create Token.
  10. Copy the token immediately — Cloudflare will only show it once.

🔗 How to Enter the Token in Search Atlas

  1. Open the Search Atlas platform and navigate to the Clearview integration settings.
  2. Paste your Cloudflare API token into the designated field.
  3. Click Connect or Save to complete the integration.
  4. Wait a few moments for the connection to verify. A green confirmation indicator means the integration is active.

🚨 Troubleshooting: Authorisation Failed (cf_10000)

If you see an error message referencing Cloudflare API Authorization failed or error code cf_10000, this usually means one of the following:

  • The token was created with missing or incorrect permissions — recreate it using the steps above.
  • The token was scoped to the wrong zone — ensure the correct domain is selected under Zone Resources.
  • The token was not copied in full — return to Cloudflare, revoke the old token, and generate a new one.

After fixing the token, return to the Clearview integration settings in Search Atlas, remove the old token, paste the new one, and reconnect.

💬 Need More Help?

If you need further assistance, open the chat widget in the bottom-right corner of the platform and type human teammate to be connected with a member of our team.