Create a new product

Creates a new product with optional image uploads.

This endpoint allows you to create products with detailed information and multiple images.

Use Cases

• Add new products to your catalog
• Create products with multiple images
• Set up product pricing and descriptions

Supported Image Formats

• JPEG/JPG
• PNG
• WebP
• Maximum 10 images per product
• Maximum file size: 5MB per image

Example Request (multipart/form-data)

name: "Premium Widget"
description: "High-quality widget for all your needs"
price: "99.99"
images: [file1.jpg, file2.jpg]  // Optional, up to 10 images

Required Fields

• name: Product name
• price: Product price (decimal number)

Optional Fields

• description: Detailed product description
• images: Product images (up to 10 files)

POST /api/v0/products

Create a new product

cURL

curl --request POST \
  --url https://api.devdraft.ai/api/v0/products \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-client-secret: <api-key>' \
  --form 'name=Premium Software License' \
  --form 'description=Annual license for our premium software suite with advanced features, priority support, and regular updates.' \
  --form price=299.99 \
  --form currency=USD \
  --form type=DIGITAL \
  --form weight=123 \
  --form 'unit=<string>' \
  --form quantity=123 \
  --form stockCount=123 \
  --form status=ACTIVE \
  --form productType=PRODUCT \
  --form 'images=<string>'

Authorizations

x-client-secretx-client-key

x-client-secret · string · header · required

Your secret API key. Keep this secure and never expose it in client-side code.

Body

multipart/form-data

name · string · required

Product name as it will appear to customers. Should be clear and descriptive.

Required string length: 1 - 200

Example:

"Premium Software License"

description · string · required

Detailed description of the product. Supports markdown formatting for rich text display.

Maximum string length: 2000

Example:

"Annual license for our premium software suite with advanced features, priority support, and regular updates."

price · number · required

Product price in the specified currency. Must be greater than 0.

Required range: x >= 0.01

Example:

299.99

currency · enum<string> · default: USD

Currency code for the price. Defaults to USD if not specified.

Available options: USD, EUR, GBP, CAD, AUD, JPY

Example:

"USD"

type · string

Product type

Example:

"DIGITAL"

weight · number

Weight of the product

unit · string

Unit of measurement

quantity · number

Quantity available

stockCount · number

Stock count

status · string

Product status

Example:

"ACTIVE"

productType · string

Product type

Example:

"PRODUCT"

images · string[]

Array of image URLs

Response

201

The product has been successfully created.