POST

/admin/api/2026-07/zones.json

Create a new zone in draft status.

Parameters

zone.namestring, requiredCustomer-facing name of the zone.

zone.coverage_typestring, requiredOne of `radius`, `postal_code`, `pickup`.

zone.coverage_valuestring, optionalRequired unless coverage_type is `pickup`. Radius in kilometers, or a comma-separated postal code list.

Error responses

422VALIDATION_ERROROne or more zone fields failed validation. See the errors object for field-level detail.

409DUPLICATE_ZONE_NAMEA zone with this name already exists on the shop.

Request body

{
  "zone": {
    "name": "North Shore",
    "coverage_type": "radius",
    "coverage_value": "15"
  }
}

Response 201

{
  "zone": {
    "name": "North Shore",
    "coverage_type": "radius",
    "coverage_value": "15"
  }
}

curl -X POST "https://{shop}.myshopify.com/admin/api/2026-07/zones.json" \
  -H "X-Shopify-Access-Token: {access_token}" \
  -H "Content-Type: application/json" \
  -d '{"zone":{"name":"North Shore","coverage_type":"radius","coverage_value":"15"}}'

zone = { name: "North Shore", coverage_type: "radius", coverage_value: "15" }
client.post(path: "zones", body: { zone: zone })

await fetch(`https://${shop}/admin/api/2026-07/zones.json`, {
  method: 'POST',
  headers: {
    'X-Shopify-Access-Token': accessToken,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    zone: { name: 'North Shore', coverage_type: 'radius', coverage_value: '15' },
  }),
});