Create a category

POST https://api.tamio.com/v2/categories/create

Creates a new product category with multilingual configuration and optional SEO settings.

Categories support hierarchical structures via parent_id, multilingual titles and descriptions via the config object, and can be associated with an image asset.

The config object must contain at least one language key (e.g. en, de) matching the languages enabled for your account. Each language entry requires a title at minimum.

Body Parameters

parent_id string

UUID of the parent category for creating hierarchical structures.

asset_id string

UUID of the image asset to associate with this category.

status boolean

Whether the category is active and visible. Defaults to true.

icon string

Icon data or URL for category display. Set to null to clear.

config object*

Multilingual configuration keyed by language code (e.g. en, de, es). Must contain between 1 and 10 language entries. Language codes must match the languages enabled on your account.

Example

{
  "config": {
    "en": {
      "title": "Electronics"
    }
  }
}

Responses

200 Category created successfully

Category created successfully

status integer

category Category

400 Validation or business logic error. Returned when:

Validation or business logic error. Returned when:

Missing required config field
Missing required title within a language config
Invalid UUID format for parent_id or asset_id
Unsupported language code in config keys
Field length violations (e.g. title shorter than 2 or longer than 240 characters)
Invalid slug pattern (spaces, special characters, or system- prefix)
Additional/unknown properties in the request body
Type mismatches (e.g. status sent as string instead of boolean)

Error codes:

Code	Description
1002	Asset or parent category not found
10156	Category name invalid (empty or missing title)
10157	Max children or max ancestors reached for parent category

status integer

error string

error_code integer

401 Unauthorized – invalid or missing Bearer token

Retrieve a category

Update a category

/categories/create

1 const response = await fetch("https://api.tamio.com/v2/categories/create", {
2   method: "POST",
3   headers: {
4     "Authorization": "Bearer YOUR_API_KEY",
5     "Content-Type": "application/json"
6   },
7   body: JSON.stringify({
8     // ... request body
9   })
10 });
11 const data = await response.json();

1 require "uri"
2 require "net/http"
3 
4 url = URI("https://api.tamio.com/v2/categories/create")
5 
6 https = Net::HTTP.new(url.host, url.port)
7 https.use_ssl = true
8 
9 request = Net::HTTP::Post.new(url)
10 request["Accept"] = "application/json"
11 request["Authorization"] = "Bearer YOUR_API_KEY"
12 request["Content-Type"] = "application/json"
13 request.body = %Q{
14   // ... request body
15 }
16 
17 response = https.request(request)
18 puts response.read_body

Responses

{
  "status": 200,
  "category": {
    "id": "c3d4e5f6-a1b2-7890-cdef-1234567890ab",
    "parent_id": "string",
    "slug": "electronics",
    "icon": "string",
    "status": true,
    "object": "category",
    "integer_id": 42,
    "name": "Electronics",
    "created_at": 1709500800,
    "asset_id": "string",
    "children": [],
    "config": {},
    "number_of_subcategories": 3,
    "number_of_products": 50,
    "number_of_sites": 2,
    "path": "string",
    "label_path": "string",
    "image": {}
  }
}

1	const response = await fetch("https://api.tamio.com/v2/categories/create", {
2	method: "POST",
3	headers: {
4	"Authorization": "Bearer YOUR_API_KEY",
5	"Content-Type": "application/json"
6	},
7	body: JSON.stringify({
8	// ... request body
9	})
10	});
11	const data = await response.json();

1	require "uri"
2	require "net/http"
3
4	url = URI("https://api.tamio.com/v2/categories/create")
5
6	https = Net::HTTP.new(url.host, url.port)
7	https.use_ssl = true
8
9	request = Net::HTTP::Post.new(url)
10	request["Accept"] = "application/json"
11	request["Authorization"] = "Bearer YOUR_API_KEY"
12	request["Content-Type"] = "application/json"
13	request.body = %Q{
14	// ... request body
15	}
16
17	response = https.request(request)
18	puts response.read_body