Cloudflare API | Zones › Create Zone

curl https://api.cloudflare.com/client/v4/zones \
    -H 'Content-Type: application/json' \
    -H "X-Auth-Email: $CLOUDFLARE_EMAIL" \
    -H "X-Auth-Key: $CLOUDFLARE_API_KEY" \
    -d '{
      "account": {},
      "name": "example.com",
      "type": "full"
    }'

200Example

{
  "errors": [
    {
      "code": 1000,
      "message": "message"
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message"
    }
  ],
  "success": true,
  "result": {
    "id": "023e105f4ecef8ad9ca31a8372d0c353",
    "account": {
      "id": "023e105f4ecef8ad9ca31a8372d0c353",
      "name": "Example Account Name"
    },
    "activated_on": "2014-01-02T00:01:00.12345Z",
    "created_on": "2014-01-01T05:20:00.12345Z",
    "development_mode": 7200,
    "meta": {
      "cdn_only": true,
      "custom_certificate_quota": 1,
      "dns_only": true,
      "foundation_dns": true,
      "page_rule_quota": 100,
      "phishing_detected": false,
      "step": 2
    },
    "modified_on": "2014-01-01T05:20:00.12345Z",
    "name": "example.com",
    "name_servers": [
      "bob.ns.cloudflare.com",
      "lola.ns.cloudflare.com"
    ],
    "original_dnshost": "NameCheap",
    "original_name_servers": [
      "ns1.originaldnshost.com",
      "ns2.originaldnshost.com"
    ],
    "original_registrar": "GoDaddy",
    "owner": {
      "id": "023e105f4ecef8ad9ca31a8372d0c353",
      "name": "Example Org",
      "type": "organization"
    },
    "paused": true,
    "status": "initializing",
    "type": "full",
    "vanity_name_servers": [
      "ns1.example.com",
      "ns2.example.com"
    ]
  }
}

Delete Zone -> Envelope<{ id }>

delete/zones/{zone_id}

Deletes an existing zone.

Edit Zone -> Envelope<

Zone

patch/zones/{zone_id}

Edits a zone. Only one zone property can be changed at a time.

Zone Details -> Envelope<

Zone

get/zones/{zone_id}

Zone Details

List Zones -> V4PagePaginationArray<

Zone

get/zones

Lists, searches, sorts, and filters your zones. Listing zones across more than 500 accounts is currently not allowed.

Domain types

Type = "full" | "partial" | "secondary"

Zone = { id, account, activated_on, 14 more... }

Zones

Activation Check

zones.activation_check

Methods

Rerun The Activation Check -> Envelope<{ id }>

put/zones/{zone_id}/activation_check

Triggeres a new activation check for a PENDING Zone. This can be triggered every 5 min for paygo/ent customers, every hour for FREE Zones.

Zones

Custom Nameservers

zones.custom_nameservers

Methods

Get Account Custom Nameserver Related Zone Metadata -> { errors, messages, success, 3 more... }

get/zones/{zone_id}/custom_ns

Get metadata for account-level custom nameservers on a zone.

Deprecated in favor of Show DNS Settings.

Set Account Custom Nameserver Related Zone Metadata -> Envelope<Array<string>>

put/zones/{zone_id}/custom_ns

Set metadata for account-level custom nameservers on a zone.

If you would like new zones in the account to use account custom nameservers by default, use PUT /accounts/:identifier to set the account setting use_account_custom_ns_by_default to true.

Deprecated in favor of Update DNS Settings.

Zones

Holds

zones.holds

Methods

Create Zone Hold -> Envelope<

ZoneHold

post/zones/{zone_id}/hold

Enforce a zone hold on the zone, blocking the creation and activation of zones with this zone's hostname.

Remove Zone Hold -> Envelope<

ZoneHold

delete/zones/{zone_id}/hold

Stop enforcement of a zone hold on the zone, permanently or temporarily, allowing the creation and activation of zones with this zone's hostname.

Update Zone Hold -> Envelope<

ZoneHold

patch/zones/{zone_id}/hold

Update the hold_after and/or include_subdomains values on an existing zone hold. The hold is enabled if the hold_after date-time value is in the past.

Get Zone Hold -> Envelope<

ZoneHold

get/zones/{zone_id}/hold

Retrieve whether the zone is subject to a zone hold, and metadata about the hold.

Domain types

ZoneHold = { hold, hold_after, include_subdomains }

Zones

Plans

zones.plans

Methods

Available Plan Details -> Envelope<

AvailableRatePlan

get/zones/{zone_id}/available_plans/{plan_identifier}

Details of the available plan that the zone can subscribe to.

List Available Plans -> SinglePage<

AvailableRatePlan

get/zones/{zone_id}/available_plans

Lists available plans the zone can subscribe to.

Domain types

AvailableRatePlan = { id, can_subscribe, currency, 7 more... }

Zones

Rate Plans

zones.rate_plans

Methods

List Available Rate Plans -> Envelope<Array<{ id, components, currency, 3 more... }>>

get/zones/{zone_id}/available_rate_plans

Lists all rate plans the zone can subscribe to.

Zones

Settings

zones.settings

Methods

Edit Zone Setting -> Envelope<

ZeroRTT

AdvancedDDoS

AlwaysOnline

| 50 more...>

patch/zones/{zone_id}/settings/{setting_id}

Updates a single zone setting by the identifier

Get Zone Setting -> Envelope<

ZeroRTT

AdvancedDDoS

AlwaysOnline

| 50 more...>

get/zones/{zone_id}/settings/{setting_id}

Fetch a single zone setting by name

Domain types

AdvancedDDoS = { id, value, editable, 1 more... }

AlwaysOnline = { id, value, editable, 1 more... }

AlwaysUseHTTPS = { id }

AutomaticHTTPSRewrites = { id, value }

AutomaticPlatformOptimization = { cache_by_device_type, cf, enabled, 3 more... }

Brotli = { id, value, editable, 1 more... }

BrowserCacheTTL = { id, value }

BrowserCheck = { id, value }

CacheLevel = { id, value }

ChallengeTTL = { id, value, editable, 1 more... }

Ciphers = { id, value, editable, 1 more... }

DevelopmentMode = { id, value, editable, 2 more... }

EarlyHints = { id, value, editable, 1 more... }

EmailObfuscation = { id, value }

FontSettings = { id, editable, modified_on, 1 more... }

H2Prioritization = { id, value, editable, 1 more... }

HotlinkProtection = { id, value, editable, 1 more... }

HTTP2 = { id, value, editable, 1 more... }

HTTP3 = { id, value, editable, 1 more... }

ImageResizing = { id, value, editable, 1 more... }

IPGeolocation = { id, value }

IPV6 = { id, value, editable, 1 more... }

MinTLSVersion = { id, value, editable, 1 more... }

Mirage = { id, value }

NEL = { id, value, editable, 1 more... }

OpportunisticEncryption = { id, value }

OpportunisticOnion = { id, value, editable, 1 more... }

OrangeToOrange = { id, value, editable, 1 more... }

OriginErrorPagePassThru = { id, value }

OriginMaxHTTPVersion = "origin_max_http_version"

Polish = { id, value }

PrefetchPreload = { id, value, editable, 1 more... }

ProxyReadTimeout = { id, value, editable, 1 more... }

PseudoIPV4 = { id, value, editable, 1 more... }

ResponseBuffering = { id, value }

RocketLoader = { id, value }

SecurityHeaders = { id, value, editable, 1 more... }

SecurityLevel = { id, value }

ServerSideExcludes = { id, value, editable, 1 more... }

SortQueryStringForCache = { id, value }

SSL = { id, value }

SSLRecommender = { id, enabled }

TLS1_3 = { id, value, editable, 1 more... }

TLSClientAuth = { id, value, editable, 1 more... }

TrueClientIPHeader = { id, value }

WAF = { id, value }

WebP = { id, value, editable, 1 more... }

Websocket = { id, value, editable, 1 more... }

ZeroRTT = { id, value, editable, 1 more... }

Zones

Subscriptions

zones.subscriptions

Methods

Create Zone Subscription -> Envelope<unknown>

post/zones/{identifier}/subscription

Create a zone subscription, either plan or add-ons.

Zone Subscription Details -> Envelope<unknown>

get/zones/{identifier}/subscription

Lists zone subscription details.

Update Zone Subscription -> Envelope<unknown>

put/zones/{identifier}/subscription

Updates zone subscriptions, either plan or add-ons.