Skip to content

publish_post_now

Broadcasts a post that is already scheduled, without waiting for its slot. The post keeps its target list — this only changes when it fires.

On this page
  1. Parameters
  2. Example request
  3. Response
Category
Publishing
REST
POST/api/tools/publish_post_now

Parameters

id
stringrequired
ObjectId of the post to broadcast.
workspaceId
stringoptional
Workspace to act on, from list_workspaces. Omit to use the default workspace on the key.

Example request

curl -X POST "https://api.postmcpai.com/api/tools/publish_post_now" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $POSTMCPAI_API_KEY" \
  -d '{
    "id": "66a50c89e4b019a2b72f"
  }'

Response

The post with its status advanced, plus per-target delivery results.

200 · application/json
{
  "success": true,
  "message": "Post broadcasted successfully to all target profiles.",
  "post": {
    "id": "66a50c89e4b019a2b72f",
    "status": "published",
    "publishedAt": "2026-07-30T16:55:00Z"
  }
}