Skip to main content
POST https://cms.thepublive.com/publisher/{publisher_id}/post/ Creates a new post. Posts are created with Draft status by default.

​
Headers

NameTypeRequiredDescription
usernamestringYesAPI Key
passwordstringYesAPI Secret
Content-TypestringYesapplication/json

​
Request Body

FieldTypeRequiredDescription
title*stringYesPost headline
english_title*stringYesEnglish headline (for slug)
type*stringYesArticle, Video, Web Story, Gallery, LiveBlog, CustomPage, BlankPage
status*stringYesDraft, Published, Scheduled, Approval Pending
primary_category*integerYesCategory ID
contributorsstringNoComma-separated author IDs
contentstringNoHTML body content
tagsstringNoComma-separated tag IDs
categoriesstringNoComma-separated additional category IDs
banner_urlintegerNoMedia ID for featured image
banner_descriptionstringNoFeatured image caption
short_descriptionstringNoSEO meta description
summarystringNoPost summary
seo_keyphrasestringNoFocus keyword
slugstringNoCustom slug (auto-generated if omitted)
meta_dataobjectNoAdditional metadata (e.g., {"access_type": "Paid"})
custom_published_atdatetimeNoBackdated publish date
scheduled_atdatetimeNoFuture publish date (status must be Scheduled)
hide_banner_imagebooleanNoHide the featured image

​
Example Request

curl -X POST \
  'https://cms.thepublive.com/publisher/123/post/' \
  -H 'username: YOUR_API_KEY' \
  -H 'password: YOUR_API_SECRET' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Getting Started with Publive API",
    "english_title": "Getting Started with Publive API",
    "type": "Article",
    "status": "Draft",
    "primary_category": 100,
    "contributors": "1,2",
    "tags": "500,501",
    "content": "<p>Learn how to integrate Publive into your application...</p>",
    "short_description": "A beginner guide to the Publive API"
  }'

{
  "status": "success",
  "message": "Created successfully",
  "data": {
    "id": 50200,
    "title": "Getting Started with Publive API",
    "english_title": "Getting Started with Publive API",
    "slug": "getting-started-with-publive-api",
    "type": "Article",
    "status": "Draft",
    "primary_category": {
      "id": 100,
      "name": "Technology",
      "slug": "technology"
    },
    "contributors": [
      {"id": 1, "name": "Jane Doe"},
      {"id": 2, "name": "John Smith"}
    ],
    "tags": [
      {"id": 500, "name": "API"},
      {"id": 501, "name": "Tutorial"}
    ],
    "content": "<p>Learn how to integrate Publive into your application...</p>",
    "banner_url": null,
    "banner_description": "",
    "short_description": "A beginner guide to the Publive API",
    "word_count": 12,
    "created_at": "2026-02-12T10:00:00Z",
    "updated_at": "2026-02-12T10:00:00Z",
    "source": "HeadlessCMS"
  }
}