---
title: "Create tracking categories"
method: PUT
path: "/TrackingCategories"
tags: ["Accounting"]
---

# Create tracking categories

`PUT /TrackingCategories`

## Headers

- `Idempotency-Key` string

## Request body

- TrackingCategory
  - `TrackingCategoryID` string, uuid — The Xero identifier for a tracking category e.g. 297c2dc5-cc47-4afd-8ec8-74990b8761e9
  - `TrackingOptionID` string, uuid — The Xero identifier for a tracking option e.g. dc54c220-0140-495a-b925-3246adc0075f
  - `Name` string — The name of the tracking category e.g. Department, Region (max length = 100)
  - `Option` string — The option name of the tracking option e.g. East, West (max length = 100)
  - `Status` 'ACTIVE' | 'ARCHIVED' | 'DELETED' — The status of a tracking category
  - `Options` TrackingOption[] — See Tracking Options
    - `TrackingOptionID` string, uuid — The Xero identifier for a tracking option e.g. ae777a87-5ef3-4fa0-a4f0-d10e1f13073a
    - `Name` string — The name of the tracking option e.g. Marketing, East (max length = 100)
    - `Status` 'ACTIVE' | 'ARCHIVED' | 'DELETED' — The status of a tracking option
    - `TrackingCategoryID` string, uuid — Filter by a tracking category e.g. 297c2dc5-cc47-4afd-8ec8-74990b8761e9

## Response `200`

Success - return response of type TrackingCategories array of newly created TrackingCategory

- TrackingCategories
  - `TrackingCategories` TrackingCategory[]
    - `TrackingCategoryID` string, uuid — The Xero identifier for a tracking category e.g. 297c2dc5-cc47-4afd-8ec8-74990b8761e9
    - `TrackingOptionID` string, uuid — The Xero identifier for a tracking option e.g. dc54c220-0140-495a-b925-3246adc0075f
    - `Name` string — The name of the tracking category e.g. Department, Region (max length = 100)
    - `Option` string — The option name of the tracking option e.g. East, West (max length = 100)
    - `Status` 'ACTIVE' | 'ARCHIVED' | 'DELETED' — The status of a tracking category
    - `Options` TrackingOption[] — See Tracking Options
      - `TrackingOptionID` string, uuid — The Xero identifier for a tracking option e.g. ae777a87-5ef3-4fa0-a4f0-d10e1f13073a
      - `Name` string — The name of the tracking option e.g. Marketing, East (max length = 100)
      - `Status` 'ACTIVE' | 'ARCHIVED' | 'DELETED' — The status of a tracking option
      - `TrackingCategoryID` string, uuid — Filter by a tracking category e.g. 297c2dc5-cc47-4afd-8ec8-74990b8761e9

## Other responses

- `400` — A failed request due to validation error

---

[API](https://skmtc.net/xeroapi/apis/xero-accounting-api.md) · [All operations](https://skmtc.net/xeroapi/apis/xero-accounting-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xeroapi/xero-accounting-api/versions/dc231cafd8de/schema)