Alerts5

Attachments8

Auth3

Conversations15

Featured content1

Forums3

Index1

Me6

Media10

Media albums8

Media categories7

Media comments6

Nodes6

OAuth24

oEmbed1

Posts7

Profile posts11

Resource categories7

Resource reviews6

Resource updates4

Resource versions4

Resources10

Search4

Search forums2

Stats1

Threads12

Users10

Media categories

Create a media category

Changed on Mar 18, 2026

Create a media category.

post/media-categories/

Request

Base URL
https://example.com/api
Auth
- OAuth 2
  Authorization codehttps://example.com/oauth2/authorize
  Token URLhttps://example.com/api/oauth2/token
  Scopesmedia_category:write
- or API key in header XF-Api-Key
TypeScript
https://skmtc.dev/xenforo-ltd/apis/xenforo-api/docs/media-categories/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body application/x-www-form-urlencoded

titlestring

parent_category_idinteger

descriptionstring

display_orderinteger

min_tagsinteger

category_typestring

allowed_typesstring[]

auto_featureboolean

Response

OK

successboolean

Changes

Mar 18, 2026e271d0e41f6d Revision changes
- breaking
  removed the media type application/json from the request body
- breaking
  the response's property type changed from string to boolean for status
- info
  api operation id post_media_categories_ removed and replaced with postMediaCategories
- info
  the endpoint scheme security XF-Api-Key was added to the API
- info
  the endpoint scheme security XF-OAuth2 was added to the API
- info
  added the new optional header request parameter XF-Api-User to all path's operations
- info
  added the new optional query request parameter api_bypass_permissions to all path's operations
Mar 6, 20260f490cfb7931 Revision changes
- info
  api tag Media categories added
- info
  api tag media-categories removed
- info
  added optional request body
- info
  added the media type application/json for the response with the status

Operation history (4 revisions)