Create a store category

POST

/store/categories

Creates a category. Send external_id to link it to your own catalog and then reference it from products with category_external_id. Requires store:write. 422 codes: category_external_id_taken, category_limit_reached (200 categories per store). (API 1.15)

Requisição

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢201Criado

application/json

Category created

Bodyapplication/json

🟠401Não Autorizado

🟠403Proibido

🟠422Erro de Parâmetro

🟠429

Request Example

Shell

JavaScript

Java

Swift

curl --location '/store/categories' \
--header 'Content-Type: application/json' \
--data '{
    "name": "string",
    "external_id": "string",
    "position": 0
}'

Response Example

201 - Exemplo 1

{
    "data": {
        "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
        "name": "string",
        "position": 0,
        "external_id": "string"
    }
}

Modificado em 2026-10-22 18:13:52

Página anterior

List store categories

Próxima página

Update a store category