Skip to navigation
RESTAdminManagementShippingV2Shipping Method

Update Shipping Method

Updates a Shipping Method in a zone. Real Time Carrier Connections are also supported by this endpoint.

Read Only Fields

  • id

Settings Objects

A shipping methodʼs type and settings properties can match one of the following models:

perorder Object – Properties

Object model for flat-rate shipping quotes per order.

PropertyTypeDescription
ratenumberFlat rate per order.

Example response:

{
  "name": "Flat Rate per Order",
  "type": "perorder",
  "settings": {
    "rate": 7
  }
},

peritem Object – Properties

Object model for flat-rate shipping quotes per item ordered.

PropertyTypeDescription
ratenumberFlat rate per item.

Example response:

{
  "name": "Flat Rate per Item",
  "type": "peritem",
  "settings": {
    "rate": 8
  }
},

weight Object – Properties

Object model for shipping quotes by weight.

PropertyTypeDescription
default_costnumber | nullDefault shipping cost, applied either as a percentage of the orderʼs total value or as a fixed amount. If default cost is not required, you can supply a value of null.
default_cost_typestringHow the default shipping cost is calculated; either percentage_of_total or fixed_amount.
rangenumberArray of range objects. The units for these ranges’ lower_limit and upper_limit properties depend on the default units set in the storeʼs control panel.

Example response:

{
  "name": "Rate per Weight",
  "type": "weight",
  "settings": {
    "default_cost": 12,
    "default_cost_type": "fixed_amount",
    "range": [
      {
        "lower_limit": 0,
        "upper_limit": 20,
        "shipping_cost": 8
      },
      {
        "lower_limit": 20,
        "upper_limit": 40,
        "shipping_cost": 12
      }
    ]
  }
}

total Object – Properties

Object model for shipping quotes by orderʼs total value.

PropertyTypeDescription
default_costnumber | nullDefault shipping cost, applied either as a percentage of the orderʼs total value or as a fixed amount. If default cost is not required, you can supply a value of null.
default_cost_typestringHow the default shipping cost is calculated; either percentage_of_total or fixed_amount.
rangenumberArray of range objects. The units for these ranges’ lower_limit and upper_limit properties are values in the storeʼs currency.

Example response:

This example sets free shipping above a certain order total:

{
  "name": "Per Total or Free",
  "type": "total",
  "settings": {
    "default_cost": 12,
    "default_cost_type": "fixed_amount",
    "range": [
      {
        "lower_limit": 0,
        "upper_limit": 5,
        "shipping_cost": 5
      },
      {
        "lower_limit": 5,
        "upper_limit": 10,
        "shipping_cost": 8
      },
      {
        "lower_limit": 10,
        "upper_limit": 20,
        "shipping_cost": 10
      },
      {
        "lower_limit": 20,
        "upper_limit": 49.99,
        "shipping_cost": 15
      },
      {
        "lower_limit": 50,
        "upper_limit": 100000,
        "shipping_cost": 0
      }       
    ]
  }
}

Range Object – Properties

Object model to define ranges for shipping quotes. Units are defined in the parent object.

PropertyTypeDescription
lower_limitnumberLower limit for order total.
upper_limitnumberUpper limit for order total.
shipping_costnumberShipping cost for orders whose total falls between the lower and upper limits.

Example response:

{
  "lower_limit": 0,
  "upper_limit": 20,
  "shipping_cost": 8
}

Channels

Example request body:

{
  "name": "Method associated to channels 1, 3",
  "type": "peritem",
  "settings": {
  "rate": 5
  },
  "channel_ids": [1, 3]
}
PropertyTypeDescription
channel_idsarrayChannels associated with the method as an array of integers.

Authentication

X-Auth-Tokenstring

OAuth scopes

UI NamePermissionParameter
Information & Settingsmodifystore_v2_information
Information & Settingsread-onlystore_v2_information_read_only

Authentication header

HeaderArgumentDescription
X-Auth-Tokenaccess_tokenFor more about API accounts that generate access_tokens, see our Guide to API Accounts.

Further reading

For example requests and more information about authenticating BigCommerce APIs, see Authentication and Example Requests.

For more about BigCommerce OAuth scopes, see our Guide to API Accounts.

For a list of API status codes, see API Status Codes.

Path parameters

zone_idintegerRequired
ID of the shipping zone.
method_idintegerRequired
ID of the shipping method within the shipping zone.
store_hashstringRequired
Permanent ID of the BigCommerce store.

Headers

AcceptstringRequiredDefaults to application/json

The MIME type of the response body.

Request

This endpoint expects an object.
namestringOptional
Display name for shipping method.
typeenumOptional
settingsobjectOptional

Depends on the shipping method type. See the supported settings object.

enabledbooleanOptional
Whether or not this shipping zone method is enabled.
handling_feesobjectOptional
is_fallbackbooleanOptional
Whether or not this shipping method is a fallback method used when advanced shipping rules are unavailable.
channel_idslist of integersOptional

List of channels associated to a method. When creating a new method, all available channels are associated by default. (Optional)

Response

OK
channel_idslist of integersOptional

List of channels associated to a method. When creating a new method, all available channels are associated by default. (Optional)

enabledbooleanOptional
Whether or not this shipping zone method is enabled.
handling_feesobjectOptional
idintegerOptionalRead-only

Shipping method ID. Read-only.

is_fallbackbooleanOptional
Whether or not this shipping method is a fallback method used when advanced shipping rules are unavailable.
namestringOptional
Display name for shipping method.
settingsobjectOptional

Depends on the shipping method type. See the supported settings object.

typeenumOptional