Skip to main content
POST https://cms.thepublive.com/publisher/{publisher_id}/category/ Creates a new category.

​
Headers

NameTypeRequiredDescription
usernamestringYesAPI Key
passwordstringYesAPI Secret
Content-TypestringYesapplication/json

​
Request Body

FieldTypeRequiredDescription
name*stringYesCategory name
english_name*stringYesEnglish name (for permalink generation)
slugstringNoCustom slug (auto-generated if omitted)
meta_titlestringNoSEO title
h1_tagstringNoH1 heading tag
meta_descriptionstringNoSEO description
priorityintegerNoPriority level (1-1000)
contentstringNoCategory description (HTML)
category_brand_colorstringNoBrand color (hex)
content_typestringNoContent type filter (e.g., Article, Web Story)

​
Example Request

curl -X POST \
  'https://cms.thepublive.com/publisher/123/category/' \
  -H 'username: YOUR_API_KEY' \
  -H 'password: YOUR_API_SECRET' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Technology",
    "english_name": "Technology",
    "meta_title": "Technology News",
    "priority": 100
  }'

{
  "status": "success",
  "message": "Created Successfully",
  "data": {
    "id": 14500,
    "name": "Technology",
    "english_name": "Technology",
    "slug": "technology",
    "absolute_url": "/technology",
    "parent_category": null,
    "category_brand_color": null,
    "content": "",
    "meta_title": "Technology News",
    "meta_description": "",
    "content_type": null
  }
}