Synup
Create a key
v1Resources/Post Ideas/postCreate a post idea

Create a post idea

Creates (or, for a repeated externalId, updates) a draft post idea, awaiting review or ready to publish.

post/api/v1/post-ideas
ideas:write
Request body
locationIdstringoptional
The location this idea is for, or omit for a brand-level idea.
clientIdstringoptional
The client this idea is for (brand-level ideas).
titlestringrequired
The idea's title. Required on create.
contentstringoptional
The idea's caption/body content.
externalIdstringrequired
A stable id you control — retrying a create with the same externalId updates the existing idea instead of duplicating it. Required on create.
originstring (channel | routine | os_button)required
Where this idea is coming from: channel, routine, or os_button. Required on create.
typestring (announcement | offer | tip | showcase | story | event)optional
Idea type.
bucketstring (idea | holiday | calendar | series)optional
Which grid bucket the idea sits in.
platformsarray of stringoptional
Platforms this idea is intended for.
imageUrlstringoptional
URL of an image to attach to the idea.
imagePromptstringoptional
The prompt used to generate the idea's image.
seriesIdstringoptional
ID of the content series to attach this idea to.
scheduledDatestringoptional
Planned publish date (YYYY-MM-DD).
scheduledTimestringoptional
Planned publish time.
generationJobIdstringoptional
ID of the AI generation job that produced this idea, if any.
Response
dataobjectoptional
idstringoptional
Unique identifier for the post idea.
createdbooleanoptional
Whether this call created a new idea (false if an idea with this externalId already existed and was updated instead).
reviewStatusstringoptional
Approval gate: null (no gate), pending, approved, or rejected.
statusstringoptional
Idea status: draft, published, or archived.
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.
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
Your API key
Request body*
{
  "data": {
    "id": "cm_idea_abc123",
    "created": true,
    "reviewStatus": null,
    "status": "draft"
  }
}