Skip to main content
POST
/
publisher
/
{publisher_id}
/
category
Create Category
curl --request POST \
  --url https://cms.thepublive.com/publisher/{publisher_id}/category/ \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "english_name": "<string>",
  "slug": "<string>",
  "meta_title": "<string>",
  "h1_tag": "<string>",
  "meta_description": "<string>",
  "parent_category": 123,
  "priority": 123,
  "content": "<string>",
  "category_brand_color": "<string>",
  "content_type": "<string>"
}
'
{
  "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
  }
}
Creates a new category.
​
publisher_id
string
required
Your Publisher ID
​
name
string
required
Category name
​
english_name
string
required
English name (used for permalink generation). Cannot be changed after creation.
​
slug
string
Custom slug (auto-generated from english_name if omitted). Cannot be changed after creation.
​
meta_title
string
SEO title
​
h1_tag
string
H1 heading tag
​
meta_description
string
SEO description
​
parent_category
integer
Parent category ID. Immutable after creation.
​
priority
integer
Priority level (1-1000)
​
content
string
Category description (HTML)
​
category_brand_color
string
Brand color (hex)
​
content_type
string
Content type filter (e.g., Article, Web Story). Cannot be changed after creation.

​
Example Request

curl -X POST \
  'https://cms.thepublive.com/publisher/123/category/' \
  -H 'Authorization: Basic <BASE64_AUTH_TOKEN>' \
  -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
  }
}