Categories
Create Category
Learn how to create a category in a store using the POST /stores//categories endpoint.
POST
Create category
📌 Endpoint
POST /stores/{storeId}/categories
Creates a new category for the informed store.
🔐 Authentication
- Private route.
- Send
Authorizationwith your API Key.
🧾 Route parameters
🧾 Body
✅ Request example
📦 Success response (201)
⚠️ Possible errors
400 INVALID_DATA→ invalid payload orstoreId400 INVALID_DATA_NAME_MIN→namemissing or shorter than 4 characters400 INVALID_DATA_NAME_MAX→namelonger than 32 characters400 INVALID_DATA_DESCRIPTION_MIN→descriptionshorter than 12 characters400 INVALID_DATA_DESCRIPTION_MAX→descriptionlonger than 256 characters400 INVALID_DATA_IMAGE→imageoutside 12 to 512 characters400 NAME_ALREADY_EXISTS→ category with the same name401 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 CATEGORY_LIMIT_REACHED→ plan category limit reached404 STORE_NOT_FOUND→ store not found429 RATE_LIMIT_EXCEEDED→ rate limit per minute exceeded500 INTERNAL_SERVER_ERROR→ internal server error503 SERVICE_UNAVAILABLE→ service or database unavailable
Body
application/json
Category details (name, description, image, metadata).