Skip to main content
POST
/
api
/
v1
/
hub
/
shop
/
{shopId}
/
shipping
/
regions
Create Shipping Region
curl --request POST \
  --url https://api.sabivendor.com/api/v1/hub/shop/{shopId}/shipping/regions \
  --header 'Content-Type: application/json' \
  --header 'X-Shop-API-Key: <x-shop-api-key>' \
  --data '
{
  "regionName": "<string>",
  "price": 123,
  "isOtherCities": true
}
'
{
  "status": "success",
  "message": "Shipping region rate created successfully",
  "data": {
    "id": 13,
    "regionName": "Lagos Island Delivery",
    "shippingFeeKobo": 250000,
    "isOtherCities": false,
    "isActive": true
  }
}
Registers a new shipping region rate configuration. Enforces uniqueness so no duplicate rate names or regions exist in the shop.

​
Authorizations

​
X-Shop-API-Key
string
required
Your Secret API Key (sk_live_... or sk_test_...) generated from the Developer dashboard. Must be kept secret.

​
Path Parameters

​
shopId
string
required
The unique UUID of the shop.

​
Request Body (JSON)

​
regionName
string
required
Custom name of the shipping region.
​
price
number
required
Delivery fee in Kobo. Must be at least 0.
​
isOtherCities
boolean
Indicates if this rate serves unmatched secondary cities.
{
  "status": "success",
  "message": "Shipping region rate created successfully",
  "data": {
    "id": 13,
    "regionName": "Lagos Island Delivery",
    "shippingFeeKobo": 250000,
    "isOtherCities": false,
    "isActive": true
  }
}