Inventory & products
Create a product
POST
/inventory/productsScope
inventory:writeAuth Bearer keyIdempotentCreates a product in a store. Leave `sku` empty to have a unique SKU generated. Prices are decimal numbers in major units (for example 2500.00 naira). New products are hidden unless you send `status: active`. An Idempotency-Key is required.
Headers
Idempotency-KeystringrequiredRetrying with the same key and payload replays the original response.
Responses
201Product
Errors
Errors use RFC 9457 problem details. Branch on code, and log request_id.
400Bad request401Unauthenticated403Forbidden409Idempotency conflict422Validation error429Rate limitedcURL
curl -X POST "https://business.boundlesspay.com/api/public/v1/inventory/products" \ -H "Authorization: Bearer $BOUNDLESS_API_KEY" \ -H "Idempotency-Key: $(uuidgen)"