---
title: "Create attribute categories"
description: "Creates attribute categories that organize assets, such as Region or Product line."
contentType: "api-reference"
url: "https://developer.mindtickle.com/docs/asset-hub/asset-taxonomy/create-attribute-categories/"
---

## Prerequisites

1. [Authentication and setup](/docs/getting-started/authentication-and-setup/): A valid access token.

## Endpoint

```http
POST /api/assethub/v2/attribute_categories
```

Base URL: the standard REST host for your region. See [Base URLs](/docs/getting-started/authentication-and-setup/#base-urls).

Headers: `Authorization: Bearer ACCESS_TOKEN`, `Content-Type: application/json`.

## Request

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `categories` | array | Required | Array of categories to create. Maximum 50 categories per request. |
| `categories[].category_name` | string | Required | Name of the category. Maximum 50 characters. Cannot be empty. |
| `user_id` | string | Required | ID of the user performing the operation. Must have the `ATTRIBUTE_MANAGEMENT` permission. |

### Request example

```json
{
  "categories": [{ "category_name": "Region" }, { "category_name": "Product" }],
  "user_id": "123456789abcd101"
}
```

## Response

| Field | Type | Description |
| --- | --- | --- |
| `categories[].category_id` | string | Unique ID of the created category. |
| `categories[].category_name` | string | Name of the created category. |
| `request_id` | string | Unique ID for the request. |

### Response example

```json
{
  "categories": [
    {
      "category_id": "123456789012345102",
      "category_name": "Region"
    },
    {
      "category_id": "123456789012345103",
      "category_name": "Product"
    }
  ],
  "request_id": "req_101"
}
```

## Notes

- **Limits:** Maximum 50 categories per request. Category name 50 characters.
- **Validation:** The category name cannot be empty.
- **Duplicates:** Category names must be unique within the organization. If a category name already exists, the response is a `Duplicate Attribute Category` error.

## Related

- [Create attributes](/docs/asset-hub/asset-taxonomy/create-attributes/): Create attributes under a category after creating it.