--- title: Create Zone --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/typescript) [Zones](https://developers.cloudflare.com/api/typescript/resources/zones) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Create Zone client.zones.create(ZoneCreateParams {account, name, type } body, RequestOptionsoptions?): [Zone]() {id, account, activated\_on, 20 more } POST/zones Creates a new zone (domain) in your Cloudflare account. The zone is created in a pending state and must be activated by updating your domain’s nameservers to point to Cloudflare, or by completing the verification process for partial (CNAME) setups. ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required) `Zone Zone Edit``Zone DNS Edit` ##### ParametersExpand Collapse
body: ZoneCreateParams {account, name, type }
account: Account id?: string Identifier maxLength32 Link to this property
Link to this property name: string The domain name. Per RFC 1035 the overall zone name can be up to 253 characters, with each segment (“label”) not exceeding 63 characters. maxLength253 Link to this property
type?: Type A full zone implies that DNS is hosted with Cloudflare. A partial zone is typically a partner-hosted zone or a CNAME setup. One of the following: "full" Link to this property "partial" Link to this property "secondary" Link to this property "internal" Link to this property
Link to this property
[Link to this property](<#(resource)%20zones%20%3E%20(method)%20create%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
Zone {id, account, activated\_on, 20 more } id: string Identifier maxLength32 Link to this property
account: Account {id, name } The account the zone belongs to. id?: string Identifier maxLength32 Link to this property name?: string The name of the account. Link to this property
Link to this property activated\_on: string| null The last time proof of ownership was detected and the zone was made active. formatdate-time Link to this property created\_on: string When the zone was created. formatdate-time Link to this property development\_mode: number The interval (in seconds) from when development mode expires (positive integer) or last expired (negative integer) for the domain. If development mode has never been enabled, this value is 0. Link to this property
meta: Meta {cdn\_only, custom\_certificate\_quota, dns\_only, 4 more } Metadata about the zone. cdn\_only?: boolean The zone is only configured for CDN. Link to this property custom\_certificate\_quota?: number Number of Custom Certificates the zone can have. Link to this property dns\_only?: boolean The zone is only configured for DNS. Link to this property foundation\_dns?: boolean The zone is setup with Foundation DNS. Link to this property page\_rule\_quota?: number Number of Page Rules a zone can have. Link to this property phishing\_detected?: boolean The zone has been flagged for phishing. Link to this property step?: number Link to this property
Link to this property modified\_on: string When the zone was last modified. formatdate-time Link to this property name: string The domain name. Per RFC 1035 the overall zone name can be up to 253 characters, with each segment (“label”) not exceeding 63 characters. maxLength253 Link to this property name\_servers: Array<string> The name servers Cloudflare assigns to a zone. Link to this property original\_dnshost: string| null DNS host at the time of switching to Cloudflare. maxLength50 Link to this property original\_name\_servers: Array<string>| null Original name servers before moving to Cloudflare. Link to this property original\_registrar: string| null Registrar for the domain at the time of switching to Cloudflare. Link to this property
owner: Owner {id, name, type } The owner of the zone. id?: string Identifier maxLength32 Link to this property name?: string Name of the owner. Link to this property type?: string The type of owner. Link to this property
Link to this property
Deprecatedplan: Plan {id, can\_subscribe, currency, 7 more } Please use the /zones/{zone_id}/subscription API to update a zone’s plan. Changing this value will create/cancel associated subscriptions. To view available plans for this zone, see Zone Plans. A Zones subscription information. id?: string Identifier maxLength32 Link to this property can\_subscribe?: boolean States if the subscription can be activated. Link to this property currency?: string The denomination of the customer. Link to this property externally\_managed?: boolean If this Zone is managed by another company. Link to this property frequency?: string How often the customer is billed. Link to this property is\_subscribed?: boolean States if the subscription active. Link to this property legacy\_discount?: boolean If the legacy discount applies to this Zone. Link to this property legacy\_id?: string The legacy name of the plan. Link to this property name?: string Name of the owner. Link to this property price?: number How much the customer is paying. Link to this property
Link to this property cname\_suffix?: string Allows the customer to use a custom apex. *Tenants Only Configuration*. Link to this property paused?: boolean Indicates whether the zone is only using Cloudflare DNS services. A true value means the zone will not receive security or performance benefits. Link to this property Deprecatedpermissions?: Array<string> This has been replaced by Account memberships. Legacy permissions based on legacy user membership information. Link to this property
status?: "initializing"| "pending"| "active"| "moved" The zone status on Cloudflare. One of the following: "initializing" Link to this property "pending" Link to this property "active" Link to this property "moved" Link to this property
Link to this property
tenant?: Tenant {id, name } The root organizational unit that this zone belongs to (such as a tenant or organization). id?: string Identifier maxLength32 Link to this property name?: string The name of the Tenant account. Link to this property
Link to this property
tenant\_unit?: TenantUnit {id } The immediate parent organizational unit that this zone belongs to (such as under a tenant or sub-organization). id?: string Identifier maxLength32 Link to this property
Link to this property
type?: Type A full zone implies that DNS is hosted with Cloudflare. A partial zone is typically a partner-hosted zone or a CNAME setup. One of the following: "full" Link to this property "partial" Link to this property "secondary" Link to this property "internal" Link to this property
Link to this property vanity\_name\_servers?: Array<string> An array of domains used for custom name servers. This is only available for Business and Enterprise plans. Link to this property verification\_key?: string Verification key for partial zone setup. Link to this property
[Link to this property](<#(resource)%20zones%20%3E%20(model)%20zone%20%3E%20(schema)>) ### Create Zone TypeScript HTTPTypeScriptPythonGoTerraform ``` import Cloudflare from 'cloudflare'; const client = new Cloudflare({ apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted }); const zone = await client.zones.create({ account: {}, name: 'example.com', }); console.log(zone.id); ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "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" }, "plan": { "id": "023e105f4ecef8ad9ca31a8372d0c353", "can_subscribe": false, "currency": "USD", "externally_managed": false, "frequency": "monthly", "is_subscribed": false, "legacy_discount": false, "legacy_id": "free", "name": "Example Org", "price": 10.99 }, "cname_suffix": "cdn.cloudflare.com", "paused": true, "permissions": [ "#worker:read" ], "status": "active", "tenant": { "id": "023e105f4ecef8ad9ca31a8372d0c353", "name": "Example Account Name" }, "tenant_unit": { "id": "023e105f4ecef8ad9ca31a8372d0c353" }, "type": "full", "vanity_name_servers": [ "ns1.example.com", "ns2.example.com" ], "verification_key": "284344499-1084221259" } } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "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" }, "plan": { "id": "023e105f4ecef8ad9ca31a8372d0c353", "can_subscribe": false, "currency": "USD", "externally_managed": false, "frequency": "monthly", "is_subscribed": false, "legacy_discount": false, "legacy_id": "free", "name": "Example Org", "price": 10.99 }, "cname_suffix": "cdn.cloudflare.com", "paused": true, "permissions": [ "#worker:read" ], "status": "active", "tenant": { "id": "023e105f4ecef8ad9ca31a8372d0c353", "name": "Example Account Name" }, "tenant_unit": { "id": "023e105f4ecef8ad9ca31a8372d0c353" }, "type": "full", "vanity_name_servers": [ "ns1.example.com", "ns2.example.com" ], "verification_key": "284344499-1084221259" } } ```