Create a post

Create a new post. A post might mean something different depending on the context and the platform. For example, a post might be a single X post or a multi-thread X post, a single LinkedIn post or a LinkedIn post with a reply, a single Instagram Reel or Story, etc.

POST/v1/posts/

Request Body

containers?array<object>

Array of post containers. Each container represents a combo for the post content with its own text and media. Use this if you want to create a post with an automated reply to the root container. Otherwise, use the 'content' field.

content?string

Simple text content for the post. Use this for single-container posts. Either 'content' or 'containers' must be provided. If you use 'containers', the first container will be the root container and the rest will be published as replies to the root container.

accountsarray<string>

Array of social media account identifiers where this post will be published. Can reference accounts by network name (e.g., 'twitter', 'linkedin') or username. Input that matches multiple accounts will publish to all matching accounts.

Items1 <= items
scheduledAt?string

ISO 8601 timestamp for when the post should be automatically published. If not provided, the post will be published immediately (unless it's a draft). If a time in the past is provided, the post will be published immediately.

Formatdate-time
threads?object

Custom and override configuration for Threads content. Not to be confused with threaded content or anything other than the Threads By Instagram - the social network.

instagram?object

Custom and override configuration for Instagram content.

youtube?object

Custom and override configuration for YouTube content.

Response Body

curl -X POST "https://api.outstand.so/v1/posts/" \  -H "Content-Type: application/json" \  -d '{    "accounts": [      "x",      "linkedin",      "mycompany"    ]  }'
{
  "success": true,
  "post": {
    "id": "9dyJS",
    "orgId": "abc123",
    "publishedAt": null,
    "scheduledAt": "2025-09-20T14:00:00Z",
    "isDraft": false
  }
}
{
  "success": false,
  "error": "Invalid payload",
  "details": {
    "content": {
      "_errors": [
        "Required"
      ]
    }
  }
}
{
  "success": false,
  "error": "Internal server error",
  "message": "Database connection failed"
}