How to connect Cloudflare to your control panel (API token)

For hosting customers · Updated 2026-10-29

On this page
  1. Before you start
  2. Step 1: create the token in Cloudflare
  3. Step 2: connect it in the panel
  4. Good to know
  5. Common questions

The Cloudflare page puts Cloudflare's network in front of your websites: faster pages worldwide and protection from attacks. It works with your own Cloudflare account, through an API token you create there.

Before you start

You need a Cloudflare account (the free plan is enough).

Step 1: create the token in Cloudflare

  1. In Cloudflare, open My Profile → API Tokens and click Create Token.
  2. Choose the Edit zone DNS template.
  3. Add these permissions:
    • Zone · Zone Settings · Edit
    • Zone · Cache Purge · Purge
    • To add new domains from the panel: Zone · Zone · Edit and Account · Account Settings · Read
  4. Under the zone resources, choose your domains or All zones.
  5. Create the token and copy it. Cloudflare shows it only once.

Step 2: connect it in the panel

  1. Log in to the control panel (https://your-server:2083).
  2. Open Cloudflare in the menu (section Domains).
  3. Under Connect your Cloudflare account, paste the token into API token.
  4. Click Connect. The message Cloudflare connected. appears and your domains are listed with their state At Cloudflare: Not added, Waiting for nameservers or Active.

Good to know

  • Use an API token, not the Global API Key. A Global API Key is refused with Paste the API token created in your Cloudflare profile (not the Global API Key).
  • The token is checked when you connect and stored encrypted.
  • The list shows your main domain, addon domains and aliases. Subdomains are managed inside their domain's Cloudflare zone.
  • Disconnect removes the token from the panel only. Nothing changes at Cloudflare: your domains stay there with their settings.

Common questions

I get "The token cannot see a Cloudflare account" when adding a domain.

The token lacks Account · Account Settings · Read or Zone · Zone · Edit. Edit the token in Cloudflare, or create a new one and connect again.

Next step?

Add your domain to Cloudflare and copy its DNS records.

Was this article helpful?

Still stuck?

Ask the AI about your exact situation — it answers from this knowledge base — or contact us.