Skip to content

Connect automatically with Cloudflare

Create a restricted API token in Cloudflare, paste it into the dashboard and we'll set up your domain name.

Is your domain's DNS at Cloudflare? Then you can connect it automatically in about five minutes. You create an API token: a key that can only change the DNS settings of your domain name. You paste it into the dashboard.

#What you need

  • A Cloudflare account that contains your domain name (its name servers point to Cloudflare, for example anna.ns.cloudflare.com).
  • It doesn't matter where you bought the domain name: what matters is that Cloudflare manages its DNS.

#Step 1: create an API token

  1. Log in to Cloudflare. Go to dash.cloudflare.com.
  2. Open your profile. Click the person icon at the top right and choose My Profile. Click API Tokens on the left. (The button may be named slightly differently.)
  3. Create a token. Click Create Token. Next to the Edit zone DNS template, click Use template.
  4. Check the permissions. Under Permissions you'll already see Zone · DNS · Edit. Click + Add more and add Zone · Zone · Read. That lets us find your domain name.
  5. Limit the token to your domain name. Under Zone Resources, choose Include · Specific zone · your domain name. Now the token can't touch your other domain names.
  6. Create the token. Click Continue to summary, then Create Token.
  7. Copy the token. You'll see a long code. Click the copy button. Cloudflare shows the token only once.

#Step 2: paste the token into the dashboard

  1. Open Domains. In your dashboard, go to your website and open Domains. Click Add domain and type your domain name.
  2. Choose Cloudflare. Choose to connect automatically and select Cloudflare.
  3. Paste the token. Paste it under API token and save.
  4. Done. We check that the token works and put the right records in place. You'll see what we did for each record.

#The orange cloud: why it's off

Every record in Cloudflare has a little cloud. Orange means visitors go through Cloudflare first (the "proxy"). Grey ("DNS only") means visitors go straight to your website.

The records we create are grey. Keep them that way: we take care of the padlock (HTTPS security) for your website ourselves, and for that visitors need to reach us directly. If you switch the cloud to orange, your site may become unreachable or the padlock may not work properly.

#What we change and what we leave alone

We only change the records your website needs: your domain's A record (and AAAA if needed), the CNAME record for www, and the records for Sending email if you switch it on.

We leave every other record alone. We never change your MX records (they decide where your email arrives).

#Security

We store the token encrypted. You can revoke it any time: in Cloudflare, go to My Profile → API Tokens, click the three dots next to the token and choose Delete (or Roll for a new token). Your website keeps working; we just can't make changes for you any more.

#Not working?

  • "Invalid token": copy the token again, without a space before or after it. Or create a new token.
  • Domain not found: is the right domain name selected under Zone Resources? Did you add Zone · Zone · Read?

You can also set the records up yourself at Cloudflare.

#Next step

Read Checking that your domain works.

Was this helpful?

Guide

Search the guide

Type a word or a question. Tip: press Ctrl K to open this anywhere.