How to upgrade your Cloudflare domain plan using the API

This guide details the steps to help you to change your plan on Cloudflare using the Cloudflare API. You can always change your plan within the user interface of the Cloudflare portal, however, you may be looking to change your plans in bulk and that is where using the Cloudflare API makes more sense.

For the purposes of Cloudflare settings, a “zone” or “domain zone” is Cloudflare’s naming convention for a “website” URL address.


  • Domain zone is already added to Cloudflare – You can simple add the domain as a Free domain zone (how to add here)
  • Domain zone ID: Zone ID retrieved from your Cloudflare portal. In my example, the zone ID for Note – this is different from the ID you see in the website URL when you’re logged into Cloudflare.
  • Cloudflare plan in mind – So you know what you want to upgrade your plan to. You will typically need to have a credit card in place within your Cloudflare portal if you plan on selecting Professional or Business plan. Or if you have purchased an Enterprise license from the Cloudflare sales team, then an Enterprise license enabled by the team in the backend.
  • Details to allow you to use the Cloudflare API – This is essentially your log in details and ensures only authorised users can make changes to your Cloudflare settings for your domain zones.
    • Auth-Email: Your Cloudflare log in email address
    • Auth-Key: Your Cloudflare Global API Key (which you’ll find in your Cloudflare settings when you’re logged in)

Overview of the process to change your domain plan

To upgrade a domain to Cloudflare Enterprise using the API, you will need to go through a two step process.

  1. Identify your CloudflarePlanIDs – Identify the Available CloudflarePlanID that is unique for your domain zone (Using the “List Available Plans” API)
  2. Edit the domain zone plan – Edit domain zone to the plan type you have chosen (Using the “Edit Zone” API)

How to upgrade your Cloudflare domain plan using the API

1. Identify your CloudflarePlan IDs using the Cloudflare API

This is required, as Cloudflare has specific Cloudflare plan IDs set up in the backend, so you will need to identify what your unique Cloudflare plan IDs are for your domain zone.

There is a unique ID for Free, Professional, Business and Enterprise plans for each of your domain zones.

Then you run the List Available Plans API within a Terminal (MacOS) or CommandPrompt (Windows).

curl -X GET "" \
-H "X-Auth-Key: YOURAPIKEY(Global-Auth-Key)" \
-H "Content-Type: application/json"

You will then receive an output for this “List Available Plans” API.

{"id":"UNIQUE-FREE-PLAN-ID","name":"Free Plan","price":0,"currency":"USD","frequency":"monthly","is_subscribed":false,"can_subscribe":true,"legacy_id":"free","legacy_discount":false,"externally_managed":false},
{"id":"UNIQUE-BUSINESS-PLAN-ID","name":"Business Plan","price":200,"currency":"USD","frequency":"monthly","is_subscribed":false,"can_subscribe":true,"legacy_id":"business","legacy_discount":false,"externally_managed":false},
{"id":"UNIQUE-PROFESSIONAL-PLAN-ID","name":"Professional Plan","price":20,"currency":"USD","frequency":"monthly","is_subscribed":false,"can_subscribe":true,"legacy_id":"pro","legacy_discount":false,"externally_managed":false},

Take note of the Unique Cloudflare Plan IDs here, and copy and paste the one you want to change your plan to.

Now we need to change the plan to that using the next API.

2. Edit the domain zone plan using the Cloudflare API

Change the domain zone plan using the Cloudflare “Edit Zone” API

curl -X PATCH "" \
-H "X-Auth-Key: YOURAPIKEY-Global-Auth-Key" \
-H "Content-Type: application/json" \
--data '{"plan":{"id":"INSERT-CLOUDFLARE-PLAN-ID-HERE"}}'

You will then receive an output for this Cloudflare “Edit Zone” API. It should look something like this but with your domain details.

{   "success": true,   
"errors": [],
"messages": [],
"result": {
"id": "ZONE-ID", "name": "", "development_mode": 7200, "original_name_servers": [ "", "" ], "original_registrar": "GoDaddy", "original_dnshost": "NameCheap", "created_on": "2014-01-01T05:20:00.12345Z", "modified_on": "2014-01-01T05:20:00.12345Z", "activated_on": "2014-01-02T00:01:00.12345Z", "owner": { "id": "OWNER-ID", "email": "[email protected]",
"type": "user" }, "account": { "id": "ACCOUNT-ID", "name": "Demo Account" },
"permissions": [ "#zone:read", "#zone:edit" ],
"plan": { "id": "CLOUDFLARE-PLAN-ID", "name": "Pro Plan", "price": 20, "currency": "USD",
"frequency": "monthly", "legacy_id": "pro",
"is_subscribed": true, "can_subscribe": true },
"plan_pending": { "id": "CLOUDFLARE-PLAN-ID", "name":
"Pro Plan", "price": 20, "currency": "USD",
"frequency": "monthly", "legacy_id": "pro",
"is_subscribed": true, "can_subscribe": true },
"status": "active", "paused": false, "type": "full",
"name_servers": [ "", "" ] } }

Then log into your Cloudflare dashboard and check if it has been changed to this new plan you have selected successfully.

Screenshots to help you

This is where you find your Cloudflare API Key (Global API Key is what you need)

This is where you find your Cloudflare Zone ID

Useful links


How do I setup custom nameservers on Cloudflare?

You may be wondering what custom nameservers on Cloudflare are. They are basically nameservers with your own naming system on the nameservers itself. You can also call them “vanity nameservers”.

On Cloudflare, you can create and enable nameservers which reflect your own domain name (eg. You can use them in place of your Cloudflare assigned nameservers (replacing them). Such that when someone looks up your nameservers, they will see the following:

[VuLong ~]$ dig ns +short

Please note that custom nameservers have the following limitations:

  • You must have between two and five custom nameservers
  • The custom nameservers can only be created as subdomains of (e.g. and
  • When custom nameservers are created, glue records need to be created at your registrar with the IP addresses of your custom nameservers. Failure to do so can cause all DNS lookups for your site to fail. Further information can be found here: Can I get vanity or custom nameservers using Cloudflare?
  • Note: Your assigned Cloudflare nameservers will continue to work even after custom nameservers are enabled.

Here’s an example of how I have enabled this for my domain –

Set up custom nameservers on Cloudflare

Set up glue records reflecting IPv4 address and IPv6 address onto your domain name registrar. In my case, I did this on my domain name registrar –

Then test this out. You can use something like this free online DNS service to make it easier to check

Happy testing and set up!

Note – this is only available on the Business and Enterprise plans.


How do I check if SSL is working on my website using Cloudflare?


These steps below assumes that you are using Cloudflare to manage your website property so it is available closer to your users around the world.

Please follow this “How to set up your website on Cloudflare” guide (selecting the Cloudflare Free plan), if you would like to have your website managed by Cloudflare. 

So how do I check if SSL is working on my website using Cloudflare?

Step 1 – Check that the Connection is Secure

When you type in your website, you should see it say the word “Secure” in the left of the address bar.
Then, when you click on this “Secure” lock, it’ll say, “Connection is secure”.

Step 2 – Check that the certificate is indeed live and verified by the web browser

You can check by using the Inspect element function available within your web browser.

  • You can do this by selecting the Chrome menu at the top-right of your browser window, then select Tools > Developer Tools.
  • Alternatively you can right-click on any page element and select Inspect Element.
  • You can use the hot keys, Ctrl+Shift+I on Windows device (or Cmd+Opt+I on Mac device) to open the DevTools (DeveloperTools).
Example of where to find the Developer Tools on a Mac device
You’ll receive a message if “This page is secure (valid HTTPS)

Step 3 – How do I check what type of SSL is working on my website?

Once you have confirmed that the SSL certificate is working on your website and it is secure, you can check how it appears to website visitors.
Cloudflare offers you a few different types of SSL certificates:

  • Free Universal SSL certificates
  • Dedicated SSL certificates
  • Custom SSL certificates
Each of these SSL certificates are secure, however, the link/ URL displayed will differ and who manages the SSL certificate.
  • Free Universal SSL certificates – shows, managed by Cloudflare
  • Dedicated SSL certificates – shows, managed by Cloudflare
  • Custom SSL certificates – shows, managed by your SSL certificate provider
Here’s an example of the Universal SSL certificate (Example A) and Dedicated SSL certificate (Example B):

Example A – – Using a free Universal SSL certificate
For my website, you’ll notice that appears as the SSL certificate for my website.

Example B – – Using a dedicated SSL certificate
For my website, you’ll notice that appears as the SSL certificate for my website.

Enjoy securing your website SSL!