Create a post

Create a new post to publish or schedule across multiple social media platforms simultaneously. A post might mean something different depending on the context and the platform — for example, a single X post, a multi-thread X post, a LinkedIn post, or an Instagram Reel or Story. Posts use a container model where each container holds content for one segment (e.g., individual tweets in an X thread, or carousel items). Specify target platforms via the accounts array containing socialAccountIds from connected accounts. Include scheduledAt (ISO 8601 format, e.g. 2025-06-01T12:00:00Z) to schedule the post for future publishing, or omit it to publish immediately. Attach media by including mediaIds from previously uploaded files (see Media API). Platform-specific options (e.g., TikTok privacy settings, YouTube categories, Pinterest board IDs) can be provided via the corresponding platform configuration objects.

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. The maximum time in the future is 30d.

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.

tiktok?object

Custom and override configuration for TikTok content.

google_business?object

Custom and override configuration for Google Business Profile content.

pinterest?object

Custom configuration for Pinterest content. board_id is required when publishing to Pinterest.

linkedin?object

Custom configuration for LinkedIn content.

Response Body

const body = JSON.stringify({  "accounts": [    "x",    "linkedin",    "mycompany"  ]})fetch("https://api.outstand.so/v1/posts/", {  method: "POST",  headers: {    "Content-Type": "application/json"  },  body})
{
  "success": true,
  "post": {
    "id": "9dyJS",
    "orgId": "abc123",
    "publishedAt": null,
    "scheduledAt": "2025-09-20T14:00:00Z",
    "isDraft": false,
    "createdAt": "2025-01-15T10:30:00Z",
    "socialAccounts": [
      {
        "nickname": "My Company",
        "network": "x",
        "username": "mycompany"
      }
    ],
    "containers": [
      {
        "id": "8xKmL",
        "content": "Check out our new product launch! #excited",
        "media": [
          {
            "id": 123,
            "url": "https://media.yoursite.com/images/launch.jpg",
            "filename": "launch-photo.jpg"
          }
        ]
      }
    ]
  }
}
{
  "success": false,
  "error": "Invalid payload",
  "details": {
    "content": {
      "_errors": [
        "Required"
      ]
    }
  }
}
{
  "success": false,
  "error": "Internal server error",
  "message": "Database connection failed"
}