POST

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

יצירת אזור חדש בסטטוס טיוטה.

פרמטרים

zone.namestring, חובההשם המוצג ללקוח עבור האזור.

zone.coverage_typestring, חובהאחד מהערכים radius, postal_code, pickup.

zone.coverage_valuestring, לא חובהנדרש אלא אם coverage_type הוא pickup. רדיוס בקילומטרים, או רשימת מיקודים מופרדת בפסיקים.

תגובות שגיאה

422VALIDATION_ERRORשדה אחד או יותר של האזור נכשל באימות. ראו את אובייקט ה-errors לפירוט ברמת השדה.

409DUPLICATE_ZONE_NAMEכבר קיים בחנות אזור עם שם זהה.

גוף הבקשה

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

תגובה 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' },
  }),
});