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 | Code | Description |

Code	Description
`1002`	Asset or parent category not found
`10156`	Category name is invalid (empty or missing title)
`10157`	Maximum children or ancestors reached for parent category
`10239`	Category quota exceeded for your account

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     "config": {
9       "en": {
10         "title": "Electronics"
11       }
12     }
13   })
14 });
15 const data = await response.json();

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

Responses

{
  "status": 200,
  "category": {
    "id": "c3d4e5f6-a1b2-7890-cdef-1234567890ab",
    "parent_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "slug": "electronics",
    "icon": "laptop",
    "status": true,
    "object": "category",
    "name": "Electronics",
    "created_at": 1709500800,
    "asset_id": "f0e1d2c3-b4a5-6789-0abc-def123456789",
    "children": [
      "d4e5f6a1-b2c3-7890-abcd-ef1234567890",
      "e5f6a1b2-c3d4-7890-abcd-ef1234567890"
    ],
    "config": {
      "en": {
        "title": "Electronics",
        "seo_title": "Buy Electronics Online",
        "description": "All electronic products",
        "seo_description": "Shop the best electronics at great prices",
        "slug": "electronics"
      },
      "de": {
        "title": "Elektronik",
        "seo_title": "Elektronik Online Kaufen",
        "description": "Alle elektronischen Produkte",
        "seo_description": "Die besten Elektronikprodukte zu günstigen Preisen",
        "slug": "elektronik"
      }
    },
    "number_of_subcategories": 3,
    "number_of_products": 50,
    "number_of_sites": 2,
    "path": "a1b2c3d4-e5f6-7890-abcd-ef1234567890/c3d4e5f6-a1b2-7890-cdef-1234567890ab",
    "label_path": "Electronics/Laptops",
    "image": {
      "public_url": "https://pub.ox31.com/uploads/12345/category-image.jpg",
      "alt_text": "Electronics category banner",
      "asset_id": "f0e1d2c3-b4a5-6789-0abc-def123456789"
    }
  }
}

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	"config": {
9	"en": {
10	"title": "Electronics"
11	}
12	}
13	})
14	});
15	const data = await response.json();

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