Shipping Zones
Create, update, and delete shipping zones with regional rules for geographic shipping rate calculation and delivery options.
Shipping Zones define the geographic regions where you deliver products and what shipping options are available in each region. Every physical product business needs this configured correctly or customers see wrong shipping costs at checkout.
What This MCP Tool Does
This tool handles full CRUD operations on shipping zones. Create zones for domestic, regional, and international delivery areas. Update zones as service areas change. Delete zones you no longer serve. Each zone becomes a container for shipping rates configured through the Shipping Rates tool.
Endpoint Reference
Create a shipping zone:
POST /stores/shipping-zones
Define a new geographic zone with name and regional parameters.
List all shipping zones:
GET /stores/shipping-zones
Retrieve all configured shipping zones.
Update a shipping zone:
PUT /stores/shipping-zones/{zoneId}
Modify zone parameters including name and geographic coverage.
Delete a shipping zone:
DELETE /stores/shipping-zones/{zoneId}
Remove a shipping zone and its associated rates.
Authentication
Requires a Private Integration Token (PIT) with the stores scope enabled.
Key Parameters
When creating or updating zones:
name— display name (e.g., “Continental US”, “International”, “Local Delivery”)- Geographic parameters defining the zone boundaries (countries, states, zip code ranges)
Important Notes
Shipping zones work in conjunction with shipping rates. The zone defines where; the rate defines how much. Create zones first, then attach rates to each zone using Shipping Rates.
Deleting a zone removes all rates associated with it. Verify that no active orders reference the zone before deletion.
For agencies setting up client storefronts that ship products, zones and rates should be part of the initial configuration alongside product catalog setup.
Common Questions
What is the typical zone structure for a US-based business? Common setups include a “Domestic” zone (all US states), a “Local” zone (specific zip codes for same-day or flat-rate delivery), and optionally an “International” zone. Complexity depends on the client’s shipping operations.
Can zones overlap? Zone overlap behavior depends on how GHL resolves shipping at checkout. Generally, the most specific matching zone takes priority.
Related MCP Tools
- Shipping Rates — Attach rates to zones
- Carrier Manager — Connect shipping carriers for rate calculation
- Store Settings — Configure store-level shipping behavior
- Order Manager — Orders reference shipping zones for fulfillment