> This page is for Developer.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

# Shipping - International Enhancements for Multi-Storefront

When you sell internationally or to multiple customer segments, you may want the available shipping methods for a shipping zone to depend on the shopper's region or segment.

To localize your storefront, you can have zones that display different methods depending on the storefront channel.
When you create a method for a zone, specify which storefront channel(s) you want a shipping method to appear. Shoppers will only see the shipping method for the zone if it applies to a channel.

## Limitations

You can't assign the following to a specific channel:

* The free shipping method on [static shipping quotes](https://support.bigcommerce.com/s/article/Shipping-Methods#static).
* [Pickup methods](/developer/docs/integrations/platform-solutions/buy-online-pick-up-in-store#pickup-methods-api) on stores using Buy Online Pickup in Store.

We don't support multiple accounts of the same carrier (e.g., using distinct accounts for UPS).

## Settings

Shipping methods have a `channel_ids` setting. This setting determines which channels can display the shipping zone's method. Shipping methods are available on all channels by default.

For reference, see the [Shipping method](/developer/api-reference/rest/admin/management/shipping/v2) endpoint of the REST Management API.

## Example

The following example creates a shipping method in a zone by sending a request to the [Create a shipping method](/developer/api-reference/rest/admin/management/shipping/v2/shipping-method/create-shipping-method) endpoint.

#### Request

**`Example request: Create a shipping method for a zone`**

```http title="Example request: Create a shipping method for a zone"
POST https://api.bigcommerce.com/stores/{{store_hash}}/v2/shipping/zones/{{zone_id}}/methods
X-Auth-Token: {{ACCESS_TOKEN}}
Accept: application/json
Content-Type: application/json

{
  "name": "Per Order",
  "type": "perorder",
  "settings": {
    "rate": 8
  },
  "enabled": true,
  "handling_fees": {
    "fixed_surcharge": "3"
  },
  "channel_ids": [1, 3]
}
```

#### Response

**`Example response: Create a shipping method for a zone`**

```json title="Example response: Create a shipping method for a zone"
{
  "id": 5,
  "name": "Per Order",
  "type": "perorder",
  "settings": {
      "rate": 8
  },
  "enabled": true,
  "handling_fees": {
      "fixed_surcharge": "3"
  },
  "channel_ids": [1, 3]
}
```

## Additional resources

* [Introduction to Multi-Storefront](/developer/docs/admin/multi-storefront)
* [Shipping methods](/developer/api-reference/rest/admin/management/shipping/v2) endpoint reference