---
title: "POST /zone"
method: POST
path: "/zone"
---

# POST /zone

`POST /zone`

Add a new zone

## Request body

- NewZoneBody
  - `zone` Zone, required
    - `name` string, required — The name of the zone
    - `type` string — Zone Type, e.g. serp, isp, mobile, etc.
  - `plan` union, required
    - object — Creates a SERP API zone for scraping search engine results.
      - `type` 'unblocker', required — Must be `unblocker` for SERP API zones.
      - `serp` true, required — Must be `true` to create a SERP API zone.
      - `country` string — Lowercase ISO 3166-1 alpha-2 country code (e.g. `us`, `gb`, `sg`). **Must be lowercase** — uppercase codes will return a misleading 'no IPs available' error. Use `any` to allow any country.
      - `solve_captcha_disable` boolean — When set to `true` it will disable captcha solving.
      - `custom_headers` boolean — When set to `true`, allows users to include custom headers in their requests.
    - object — Creates a Scraping Browser zone.
      - `type` 'browser_api', required — Must be `browser_api` for Scraping Browser zones.
      - `country` string — Lowercase ISO 3166-1 alpha-2 country code (e.g. `us`, `gb`, `sg`). **Must be lowercase** — uppercase codes will return a misleading 'no IPs available' error. Use `any` to allow any country.
      - `custom_headers` boolean — When set to `true`, allows users to include custom headers in their requests.
    - object — Creates a Residential proxy zone.
      - `type` 'resident', required — Must be `resident` for Residential proxy zones.
      - `country` string — Lowercase ISO 3166-1 alpha-2 country code (e.g. `us`, `gb`, `sg`). **Must be lowercase** — uppercase codes will return a misleading 'no IPs available' error. Use `any` to allow any country.
      - `city` boolean — `true` when enabling City targeting permission.
      - `asn` boolean — `true` when enabling ASN targeting permission.
      - `vip` boolean — `true` when allocating gIP (group of IPs).
      - `vips` integer — Number of gIP (group of IPs) to allocate to the zone.
      - `vips_type` 'shared' | 'domain' — `shared` for shared (pay-per-usage) Residential. `domain` for dedicated gIPs, which require a `domain_whitelist`.
      - `vip_country` string — Lowercase ISO 3166-1 alpha-2 country code for dedicated gIP allocation. Only valid with `vips_type: domain`.
      - `vip_country_city` string — Country code followed by city (e.g. `se-stockholm`). Required when `vip` is `true` and city targeting is needed.
      - `ip_alloc_preset` 'shared_block' | 'shared_res_block' — To set a zone with Shared - Pay per usage type.
      - `domain_whitelist` string — Space-separated list of target domains. Required when `vips_type` is `domain`. Dedicated Residential gIPs are exclusive to these domains.
      - `custom_headers` boolean — When set to `true`, allows users to include custom headers in their requests.
    - object — Creates a Mobile proxy zone. Uses `resident` plan type with `mobile: true`.
      - `type` 'resident', required — Must be `resident` for Mobile proxy zones.
      - `mobile` true, required — Must be `true` to create a Mobile proxy zone.
      - `country` string — Lowercase ISO 3166-1 alpha-2 country code (e.g. `us`, `gb`, `sg`). **Must be lowercase** — uppercase codes will return a misleading 'no IPs available' error. Use `any` to allow any country.
      - `city` boolean — `true` when enabling City targeting permission.
      - `vip` boolean — `true` when allocating gIP (group of IPs).
      - `vips` integer — Number of gIP (group of IPs) to allocate to the zone.
      - `vips_type` 'shared' | 'domain' — Type of gIP allocation.
      - `custom_headers` boolean — When set to `true`, allows users to include custom headers in their requests.
    - object — Creates a shared ISP proxy zone billed per GB. `pool_ip_type: static_res` is required — omitting it silently creates a Datacenter zone instead.
      - `type` 'static', required — Must be `static` for ISP proxy zones.
      - `pool_ip_type` 'static_res', required — Must be `static_res` to create an ISP proxy zone. Default is `dc` (Datacenter).
      - `ips_type` 'shared', required — Must be `shared` for this zone type.
      - `country` string, required — Lowercase ISO 3166-1 alpha-2 country code (e.g. `us`, `gb`, `sg`). **Must be lowercase** — uppercase codes will return a misleading 'no IPs available' error. Use `any` to allow any country.
      - `custom_headers` boolean — When set to `true`, allows users to include custom headers in their requests.
    - object — Creates a shared ISP proxy zone with unlimited bandwidth. `unl_bw_tiers: std` is required — without it, `bandwidth: unlimited` is silently ignored and the zone bills per GB.
      - `type` 'static', required — Must be `static` for ISP proxy zones.
      - `pool_ip_type` 'static_res', required — Must be `static_res` to create an ISP proxy zone.
      - `ips_type` 'shared', required — Must be `shared` for this zone type.
      - `bandwidth` 'unlimited', required — Must be `unlimited` to enable unlimited bandwidth billing.
      - `unl_bw_tiers` 'std', required — **Required** to activate unlimited bandwidth billing. Without this field the zone defaults to pay-per-GB even if `bandwidth: unlimited` is set.
      - `country` string, required — Lowercase ISO 3166-1 alpha-2 country code (e.g. `us`, `gb`, `sg`). **Must be lowercase** — uppercase codes will return a misleading 'no IPs available' error. Use `any` to allow any country.
      - `custom_headers` boolean — When set to `true`, allows users to include custom headers in their requests.
    - object — Creates a dedicated ISP proxy zone with unlimited bandwidth and a fixed number of IPs.
      - `type` 'static', required — Must be `static` for ISP proxy zones.
      - `pool_ip_type` 'static_res', required — Must be `static_res` to create an ISP proxy zone.
      - `ips_type` 'dedicated', required — Must be `dedicated` for this zone type.
      - `bandwidth` 'unlimited', required — Must be `unlimited` for dedicated ISP zones.
      - `unl_bw_tiers` 'std', required — **Required** to activate unlimited bandwidth billing.
      - `country` string, required — Lowercase ISO 3166-1 alpha-2 country code (e.g. `us`, `gb`, `sg`). **Must be lowercase** — uppercase codes will return a misleading 'no IPs available' error. Use `any` to allow any country.
      - `country_city` string — Country code followed by city (e.g. `se-stockholm`) to target a specific city.
      - `ips` integer, required — Number of dedicated IPs to allocate to the zone.
      - `custom_headers` boolean — When set to `true`, allows users to include custom headers in their requests.
    - object — Creates a shared Datacenter proxy zone.
      - `type` 'static', required — Must be `static` for Datacenter proxy zones.
      - `pool_ip_type` 'dc' — Set to `dc` for Datacenter (default). Omitting this field also defaults to Datacenter.
      - `ips_type` 'shared', required — Must be `shared` for this zone type.
      - `country` string — Lowercase ISO 3166-1 alpha-2 country code (e.g. `us`, `gb`, `sg`). **Must be lowercase** — uppercase codes will return a misleading 'no IPs available' error. Use `any` to allow any country.
      - `domain_whitelist` string — Space separated list of allowlisted domains
      - `custom_headers` boolean — When set to `true`, allows users to include custom headers in their requests.
    - object — Creates a dedicated Datacenter proxy zone with a fixed number of IPs.
      - `type` 'static', required — Must be `static` for Datacenter proxy zones.
      - `pool_ip_type` 'dc' — Set to `dc` for Datacenter (default).
      - `ips_type` 'dedicated', required — Must be `dedicated` for this zone type.
      - `ips` integer, required — Number of dedicated IPs to allocate to the zone.
      - `country` string — Lowercase ISO 3166-1 alpha-2 country code (e.g. `us`, `gb`, `sg`). **Must be lowercase** — uppercase codes will return a misleading 'no IPs available' error. Use `any` to allow any country.
      - `country_city` string — Country code followed by city (e.g. `se-stockholm`) to target a specific city.
      - `domain_whitelist` string — Space separated list of allowlisted domains
      - `custom_headers` boolean — When set to `true`, allows users to include custom headers in their requests.

## Response `201`

Zone added

---

[API](https://skmtc.net/brightdata/apis/bright-data-api.md) · [All operations](https://skmtc.net/brightdata/apis/bright-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brightdata/bright-data-api/versions/7413c80b3b56/schema)