Skip to main content
POST
Create product

📌 Endpoint

POST /stores/{storeId}/products Creates a new product in the store.

🔐 Authentication

  • Private route.
  • Requires header Authorization with 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 or storeId
  • 400 INVALID_DATA_NAME_MIN → name missing or shorter than 3 characters
  • 400 INVALID_DATA_NAME_MAX → name longer than 32 characters
  • 400 INVALID_DATA_IMAGE → image longer than 512 characters
  • 400 INVALID_DATA_DESCRIPTION_MIN → description shorter than 12 characters
  • 400 INVALID_DATA_DESCRIPTION_MAX → description longer than 256 characters
  • 400 INVALID_DATA_DELIVERY → delivery missing or other than DIGITAL/PHYSICAL
  • 400 INVALID_DATA_PRICE → price missing or outside 0.5 to 9999
  • 400 INVALID_DATA_STOCK → stock outside -1 to 9999
  • 400 INVALID_DATA_CATEGORY_ID → an element in categoryIds is empty or longer than 50 characters
  • 400 RELATION_NOT_FOUND → one or more categories in categoryIds were not found in the store
  • 400 NAME_ALREADY_EXISTS → a product with this name already exists
  • 401 API_KEY_NOT_PROVIDED → Authorization header not sent (or TOKEN_NOT_PROVIDED via Bearer)
  • 401 INVALID_API_KEY → invalid API Key (or INVALID_TOKEN / TOKEN_EXPIRED / SESSION_NOT_FOUND / SESSION_EXPIRED / UNAUTHENTICATED via Bearer)
  • 403 USER_DISABLED → user disabled or deleted
  • 403 NO_ACTIVE_SUBSCRIPTION → inactive or expired plan (or PENDING_2FA via Bearer)
  • 403 PRODUCT_LIMIT_REACHED → plan product limit reached
  • 404 STORE_NOT_FOUND → store not found
  • 429 RATE_LIMIT_EXCEEDED → rate limit per minute exceeded
  • 500 INTERNAL_SERVER_ERROR → internal error
  • 503 SERVICE_UNAVAILABLE → service or database unavailable

Authorizations

Authorization
string
header
default:YOUR_API_KEY_HERE
required

Path Parameters

storeId
string
required
Required string length: 1 - 50

Body

application/json

Product details (name, price, stock, categories).

Fields documented on the reference page.

Response

Create product.

code
string
required
Example:

"SUCCESS"

product
object
required

Store product.