> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Category

> Create a custom issue category.

## Overview

Adds a category to your org's catalog. Issue `category` is free-form on creation, so this endpoint is only needed when you want a category to appear in pickers before any issue uses it.

***

## Headers

**authorization** `string` *required*

Your API key for authentication.

***

## Body Parameters

**name** `string` *required*

Category name. 1-64 characters. Case is preserved.

***

## Response

Returns `201 Created` with the new category.

**data** `object`

**Category fields**

**id** `string`

UUID of the new category.

**org\_id** `string`

**name** `string`

**created\_at** `string`

**errors** `null | array`

`null` on success.

```json Response theme={null}
{
  "data": {
    "id": "5cc60a90-dfa3-4bd9-a8e7-5ee4dd1e1b87",
    "org_id": "5fa6dc9e-ec4d-4f94-9e0e-21f6f6a1e8f1",
    "name": "Voicemail Detection",
    "created_at": "2026-05-07T05:32:42.086Z"
  },
  "errors": null
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.