Skip to main content
POST
Create category

Authorizations

Authorization
string
header
required

Your secret key as a Bearer token. The key prefix selects the environment: sk_test_... (staging) or sk_live_... (production); a key on the wrong host is refused with 403 Unauthorized Access. Each key is limited to 10 requests per minute (429 beyond that) and, on production, to the IP addresses on your dashboard allowlist when one is configured.

Body

multipart/form-data
name
string
required
Example:

"Electronics"

description
string
Example:

"Phones, laptops, gadgets"

imageUrl
file
category_position
integer

Optional 1-based position of the category in your list.

Required range: x >= 1

Response

Category created.

status
integer
Example:

200

message
string
Example:

"Category fetched successfully"

data
object