Sign in

v1

latestSwagger 2.0Private2026-08-04128286690.5 KB
Social

POST (create) a social media post

Creates a new social media post that can be published immediately or scheduled for later publication. A post can target one or more social profiles, and can include text, images, and network-specific settings.

Set status to DRAFT to save without publishing, or SCHEDULED to schedule for publication. Scheduled posts require a scheduled_time in ISO-8601 format.

Post content and settings can vary per profile — each profile_posts entry can have its own text, images, and network-specific settings (e.g., TikTok-specific settings like disable_comment).

post/social/posts

Request body

namestring

Campaign name for this post. Optional on creation. If not provided, a default name will be generated. The value provided will be sanitized before saving, so the value returned may not exactly match what was sent.

scheduled_timestring

The date and time to publish the post, in ISO-8601 format. Only applies when <code>status</code> is <code>SCHEDULED</code>. If not specified for a scheduled post, the publish job is scheduled to execute immediately.

statusstring required

The status of the post on creation. Valid values are <code>DRAFT</code> (save without publishing) or <code>SCHEDULED</code> (schedule for publication).

Example request

{
  "name": "My Social Post",
  "profile_posts": [
    {
      "images": [
        {
          "url": "https://www.host.com/path+with%20space?q=query%20with+space"
        }
      ],
      "profiles": [
        {
          "network": "facebook"
        }
      ]
    }
  ],
  "scheduled_time": "2026-03-15T14:30:00.000Z",
  "status": "SCHEDULED"
}

Response

OK

campaign_idstring

Unique identifier for the post campaign. Generated by the server on creation. Use this value to reference the post in subsequent requests.

namestring

Campaign name for this post. The value provided on creation is sanitized before saving, so the returned value may not exactly match what was sent.

scheduled_timestring

The date and time to publish the post, in ISO-8601 format. Only set when <code>status</code> is <code>SCHEDULED</code>.

statusstring required

The current status of the post. Possible values include:

<ul> <li><code>DRAFT</code> — saved without being scheduled for publication</li> <li><code>SCHEDULED</code> — scheduled for future publication at <code>scheduled_time</code></li> <li><code>EXECUTING</code> — currently being published</li> <li><code>ACTIVE</code> — the post has been published and is active on the social network</li> <li><code>PAUSED</code> — publication has been paused</li> <li><code>SUSPENDED</code> — publication has been suspended</li> <li><code>REMOVED</code> — the post has been removed</li> <li><code>DONE</code> — publication has completed</li> <li><code>ERROR</code> — publication encountered an error</li> </ul>

Example response

{
  "name": "My Social Post",
  "profile_posts": [
    {
      "images": [
        {
          "url": "https://www.host.com/path+with%20space?q=query%20with+space"
        }
      ],
      "profiles": [
        {
          "network": "facebook"
        }
      ]
    }
  ],
  "scheduled_time": "2026-03-15T14:30:00.000Z",
  "status": "SCHEDULED"
}