> ## 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

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

***

## Body Parameters

<ParamField body="name" type="string" required>
  Category name. 1-64 characters. Case is preserved.
</ParamField>

***

## Response

Returns `201 Created` with the new category.

<ResponseField name="data" type="object">
  <Expandable title="Category fields">
    <ResponseField name="id" type="string">
      UUID of the new category.
    </ResponseField>

    <ResponseField name="org_id" type="string" />

    <ResponseField name="name" type="string" />

    <ResponseField name="created_at" type="string" />
  </Expandable>
</ResponseField>

<ResponseField name="errors" type="null | array">
  `null` on success.
</ResponseField>

<ResponseExample>
  ```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
  }
  ```
</ResponseExample>

***

Docs for agents: [llms.txt](/llms.txt)