## **🌐 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.