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

application/json

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.

Array Item

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

Array Item

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.

Show Attributes

instagram?object

Custom and override configuration for Instagram content.

Show Attributes

youtube?object

Custom and override configuration for YouTube content.

Show Attributes

tiktok?object

Custom and override configuration for TikTok content.

Show Attributes

google_business?object

Custom and override configuration for Google Business Profile content.

Show Attributes

pinterest?object

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

Show Attributes

Response Body

200application/json

400application/json

500application/json

JavaScript

Go

Java

C#

cURL

TypeScript

Python

Swift

const body = JSON.stringify({
  "accounts": [\
    "x",\
    "linkedin",\
    "mycompany"\
  ]
})

fetch(" {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body
})

200400500

{
  "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": "
            "filename": "launch-photo.jpg"\
          }\
        ]\
      }\
    ]
  }
}

{
  "success": false,
  "error": "Invalid payload",
  "details": {
    "content": {
      "_errors": [\
        "Required"\
      ]
    }
  }
}

{
  "success": false,
  "error": "Internal server error",
  "message": "Database connection failed"
}

Post Lifecycle\ \ Previous Page List posts GET\ \ Next Page