Skip to main content
POST
/
store
/
shipping-zone
/
{shippingZoneId}
/
shipping-rate
Create Shipping Rate
curl --request POST \
  --url https://services.leadconnectorhq.com/store/shipping-zone/{shippingZoneId}/shipping-rate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "altId": "6578278e879ad2646715ba9c",
  "altType": "location",
  "name": "North zone",
  "currency": "USD",
  "amount": 99.99,
  "conditionType": "price",
  "minCondition": 99.99,
  "maxCondition": 99.99,
  "shippingCarrierId": "655b33a82209e60b6adb87a5",
  "description": "Ships next day",
  "isCarrierRate": true,
  "percentageOfRateFee": 10.99,
  "shippingCarrierServices": [
    {
      "name": "Priority Mail Express International",
      "value": "PriorityMailExpressInternational"
    }
  ]
}
'
{
  "status": true,
  "data": {
    "altId": "6578278e879ad2646715ba9c",
    "altType": "location",
    "name": "North zone",
    "currency": "USD",
    "amount": 99.99,
    "conditionType": "price",
    "minCondition": 99.99,
    "maxCondition": 99.99,
    "shippingCarrierId": "655b33a82209e60b6adb87a5",
    "_id": "655b33a82209e60b6adb87a5",
    "shippingZoneId": "655b33a82209e60b6adb87a5",
    "createdAt": "2023-12-12T09:27:42.355Z",
    "updatedAt": "2023-12-12T09:27:42.355Z",
    "description": "Ships next day",
    "isCarrierRate": true,
    "percentageOfRateFee": 10.99,
    "shippingCarrierServices": [
      {
        "name": "Priority Mail Express International",
        "value": "PriorityMailExpressInternational"
      }
    ]
  },
  "message": "Successfully created"
}

Authorizations

​
Authorization
string
header
required

Use the Access Token generated with user type as Sub-Account (OR) Private Integration Token of Sub-Account.

Path Parameters

​
shippingZoneId
string
required

ID of the item that needs to be returned

Example:

"6578278e879ad2646715ba9c"

Body

application/json
​
altId
string
required

Location Id or Agency Id

Example:

"6578278e879ad2646715ba9c"

​
altType
enum<string>
required
Available options:
location
​
name
string
required

Name of the shipping zone

Example:

"North zone"

​
currency
string
required

The currency of the amount of the rate / handling fee

Example:

"USD"

​
amount
number
required

The amount of the shipping rate if it is normal rate (0 means free ). Fixed Handling fee if it is a carrier rate (it will add to the carrier rate).

Example:

99.99

​
conditionType
enum<string>
required

Type of condition to provide the conditional pricing

Available options:
none,
price,
weight
Example:

"price"

​
minCondition
number
required

Minimum condition for applying this price. set 0 or null if there is no minimum

Example:

99.99

​
maxCondition
number
required

Maximum condition for applying this price. set 0 or null if there is no maximum

Example:

99.99

​
shippingCarrierId
string
required

Shipping carrier id

Example:

"655b33a82209e60b6adb87a5"

​
description
string

Delivery description

Example:

"Ships next day"

​
isCarrierRate
boolean

is this a carrier rate

Example:

true

​
percentageOfRateFee
number

Percentage of rate fee if it is a carrier rate.

Example:

10.99

​
shippingCarrierServices
object[]

An array of items

Response

Successful response

​
status
boolean
required

Status of api action

Example:

true

​
data
object
required
​
message
string

Success message

Example:

"Successfully created"

Last modified on March 4, 2026