---
title: "Create a resource category"
method: POST
path: "/resource-categories/"
tags: ["Resource categories"]
---

# Create a resource category

`POST /resource-categories/`

Create a resource category.

## Response `200`

OK

- object
  - `success` boolean
  - `category` XFRMCategory
    - `prefixes` XFRMResourcePrefix[]
      - `prefix_id` integer
      - `title` string
      - `description` string
      - `usage_help` string
      - `is_usable` boolean — True if the acting user can use (select) this prefix.
      - `prefix_group_id` integer
      - `display_order` integer
      - `materialized_order` integer — Effective order, taking group ordering into account.
    - `custom_fields` object[]
    - `can_add` boolean
    - `can_upload_images` boolean
    - `view_url` string
    - `resource_category_id` integer
    - `title` string
    - `description` string
    - `resource_count` integer
    - `last_update` integer
    - `last_resource_title` string
    - `last_resource_id` integer
    - `allow_local` boolean
    - `allow_external` boolean
    - `allow_commercial_external` boolean
    - `allow_fileless` boolean
    - `min_tags` integer
    - `enable_versioning` boolean
    - `enable_support_url` boolean
    - `parent_category_id` integer
    - `display_order` integer

## Other responses

- `default` — Error

## Changes

- **2026-03-18** `e271d0e41f6d` — 2 breaking, 5 info
  - removed the media type `application/json` from the request body
  - the `success` response's property type/format changed from `string`/`` to `boolean`/`` for status `200`
  - api operation id `post_resource_categories_` removed and replaced with `postResourceCategories`
  - the endpoint scheme security `XF-Api-Key` was added to the API
  - …3 more
- **2026-03-06** `0f490cfb7931` — 4 info
  - api tag `Resource categories` added
  - api tag `resource-categories` removed
  - added optional request body
  - added the media type `application/json` for the response with the status `200`
- **2026-02-05** `488d42c463a9` — 1 info
  - endpoint added
- **2026-02-03** `fc0a40f3b859` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/xenforo-ltd/apis/xenforo-api/changes/resource-categories/post.md)

---

[API](https://skmtc.dev/xenforo-ltd/apis/xenforo-api.md) · [All operations](https://skmtc.dev/xenforo-ltd/apis/xenforo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/xenforo-ltd/xenforo-api/revisions/b15eba33657a/schema)