Skip to main content
SHR

Shipping Rates

Commerce & Products · Intermediate · Updated March 2026

Configure shipping rates by zone, weight, and method with support for calculated rates and free shipping thresholds.

Shipping Rates define what customers pay for delivery within each shipping zone. Flat rates, weight-based pricing, free shipping over a threshold — all configured here and applied automatically at checkout.

What This MCP Tool Does

This tool lets you create shipping rate configurations, list existing rates, and check which rates are available for a given order context. Rates are attached to shipping zones and can vary by weight, method, and price threshold.

Endpoint Reference

Create a shipping rate: POST /stores/shipping-rates Define a new rate with amount, method, zone association, and conditions.

List all shipping rates: GET /stores/shipping-rates Retrieve all configured rates across zones.

Get available rates: GET /stores/shipping-rates/available Check which rates apply to a specific order context (zone, weight, order total).

Authentication

Requires a Private Integration Token (PIT) with the stores scope enabled.

Key Parameters

When creating rates:

  • Zone association (which Shipping Zone this rate applies to)
  • Rate amount (flat or calculated)
  • Method name (e.g., “Standard”, “Express”, “Overnight”)
  • Weight-based conditions (if applicable)
  • Free shipping threshold (order total above which shipping becomes free)

Important Notes

Rates require zones to exist first. Create your zone structure through Shipping Zones, then attach rates to each zone.

The “available rates” endpoint is useful for building custom checkout experiences where you need to display shipping options dynamically based on the customer’s location and cart contents.

Free shipping thresholds are a proven conversion tactic. Configure them through rate conditions rather than hardcoding in the checkout flow.

Common Questions

Can I offer free shipping for orders over a certain amount? Yes. Configure a rate with a free shipping threshold. When the order total exceeds the threshold, the rate drops to zero automatically.

How do weight-based rates work? Rates can include weight ranges. The system matches the total order weight to the appropriate rate tier within the zone.

Can I have multiple rate options in the same zone? Yes. A single zone can have Standard, Express, and Overnight options at different price points. Customers choose at checkout.