Skip to main content
POST
Create Product
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

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

Path Parameters

string
required
The unique UUID of the shop.

Request Body (Multipart / Form Data)

string
required
Name of the product.
string
Description text. Must be between 10 and 500 characters.
number
required
Price in Kobo (e.g. 1500000 for ₦15,000.00). Must be at least 0.
number
required
Initial inventory count. Must be at least 0.
number
required
Currency ID reference.
string
required
active or draft.
file
required
Upload 1 to 6 image files.