Products
Create Product
Learn how to create products using the endpoint POST /stores//products.
POST
Create product
📌 Endpoint
POST /stores/{storeId}/products
Creates a new product in the store.
🔐 Authentication
- Private route.
- Requires header
Authorizationwith your API key and active plan.
🧾 Route parameters
🧍 Body (JSON)
✅ Example request
Standard snippet (cURL)
Use the cURL example from the Request example section above as the official snippet.📦 Success response (200)
⚠️ Possible errors
400 INVALID_DATA→ invalid body orstoreId400 INVALID_DATA_NAME_MIN→namemissing or shorter than 3 characters400 INVALID_DATA_NAME_MAX→namelonger than 32 characters400 INVALID_DATA_IMAGE→imagelonger than 512 characters400 INVALID_DATA_DESCRIPTION_MIN→descriptionshorter than 12 characters400 INVALID_DATA_DESCRIPTION_MAX→descriptionlonger than 256 characters400 INVALID_DATA_DELIVERY→deliverymissing or other thanDIGITAL/PHYSICAL400 INVALID_DATA_PRICE→pricemissing or outside0.5to9999400 INVALID_DATA_STOCK→stockoutside-1to9999400 INVALID_DATA_CATEGORY_ID→ an element incategoryIdsis empty or longer than 50 characters400 RELATION_NOT_FOUND→ one or more categories incategoryIdswere not found in the store400 NAME_ALREADY_EXISTS→ a product with this name already exists401 API_KEY_NOT_PROVIDED→Authorizationheader not sent (orTOKEN_NOT_PROVIDEDvia Bearer)401 INVALID_API_KEY→ invalid API Key (orINVALID_TOKEN/TOKEN_EXPIRED/SESSION_NOT_FOUND/SESSION_EXPIRED/UNAUTHENTICATEDvia Bearer)403 USER_DISABLED→ user disabled or deleted403 NO_ACTIVE_SUBSCRIPTION→ inactive or expired plan (orPENDING_2FAvia Bearer)403 PRODUCT_LIMIT_REACHED→ plan product limit reached404 STORE_NOT_FOUND→ store not found429 RATE_LIMIT_EXCEEDED→ rate limit per minute exceeded500 INTERNAL_SERVER_ERROR→ internal error503 SERVICE_UNAVAILABLE→ service or database unavailable
Body
application/json
Product details (name, price, stock, categories).
Fields documented on the reference page.