Synupv1
Create a key
v1Resources/Post Ideas/postPublish a post idea

Publish a post idea

Publishes a post idea as a real post, submitting it to its target platforms. Unless scheduledFor or draft is set, this sends real content live immediately. id accepts either the idea's own id or the external id it was created with.

post/api/v1/post-ideas/{id}/publish
posts:write
Query parameters
idstringrequired
The post idea to publish — its id or externalId.
Request body
scheduledForstringoptional
Publish at this future ISO 8601 timestamp instead of immediately.
draftbooleanoptional
Save as a draft post instead of publishing immediately.
Response
dataobjectoptional
A requested platform with no active connection, or a field the idea needs before it can go live, never fails this call — the idea is saved as a draft post instead. Calling this again for an idea that already has a post returns alreadyPublished: true rather than creating a second one.
postIdstringoptional
ID of the post this idea published as, or null if publishing didn't complete.
statusstringoptional
Idea status: draft, published, or archived.
ideaIdstringoptional
ID of the post idea that was published.
alreadyPublishedbooleanoptional
Whether this idea already had a post from an earlier call — when true, nothing new was published.
missingFieldsarray of stringoptional
Fields still needed before the resulting post can go live, if any.
missingPlatformsarray of stringoptional
Requested platforms with no active connection, if any.
scopestring (location | client)optional
Whether the connection/field gap applies at the location or client level.
Errors
400The request is missing a required parameter or is otherwise malformed.
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
404The resource wasn't found, or doesn't belong to your agency.
422The request is missing a required parameter or is otherwise malformed.
429Too many requests. Retry after the number of seconds in the Retry-After header.
post/api/v1/post-ideas/{id}/publish
Your API key
id *
Request body
{
  "data": {
    "postId": "cm_post_xyz789",
    "status": "scheduled",
    "ideaId": "cm_idea_abc123"
  }
}