Skip to main content
POST
/
api
/
v1
/
hub
/
shop
/
{shopId}
/
product
/
create
Create Product
curl --request POST \
  --url https://api.sabivendor.com/api/v1/hub/shop/{shopId}/product/create \
  --header 'Content-Type: application/json' \
  --header 'X-Shop-API-Key: <x-shop-api-key>' \
  --data '
{
  "productName": "<string>",
  "productDescription": "<string>",
  "productPrice": 123,
  "productQuantity": 123,
  "productCurrencyId": 123,
  "productStatus": "<string>"
}
'
{
  "status": "success",
  "message": "Product created successfully",
  "data": {
    "id": 101,
    "productName": "Premium Running Shoes",
    "productSlug": "premium-running-shoes",
    "productDescription": "High performance running shoes",
    "productPrice": 1500000,
    "stockQuantity": 100,
    "isActive": true,
    "createdAt": "2026-06-19T15:35:00.000Z"
  }
}
Creates a new product catalog listing in the store inventory. This endpoint parses multipart form files for uploading catalog images. Includes detailed Zod schema validation:
  1. Product name is required.
  2. Description must be between 10 and 500 characters.
  3. Currency ID must exist in the system.
  4. Price and quantity must be non-negative numbers.
  5. Media must have at least 1 image and at most 6.

​
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 (Multipart / Form Data)

​
productName
string
required
Name of the product.
​
productDescription
string
Description text. Must be between 10 and 500 characters.
​
productPrice
number
required
Price in Kobo (e.g. 1500000 for ₦15,000.00). Must be at least 0.
​
productQuantity
number
required
Initial inventory count. Must be at least 0.
​
productCurrencyId
number
required
Currency ID reference.
​
productStatus
string
required
active or draft.
​
media
file
required
Upload 1 to 6 image files.
{
  "status": "success",
  "message": "Product created successfully",
  "data": {
    "id": 101,
    "productName": "Premium Running Shoes",
    "productSlug": "premium-running-shoes",
    "productDescription": "High performance running shoes",
    "productPrice": 1500000,
    "stockQuantity": 100,
    "isActive": true,
    "createdAt": "2026-06-19T15:35:00.000Z"
  }
}