Sign in
Posts

Create Post

Creates a post for the given social accounts. Note: links are automatically stripped from the caption before publishing to X/Twitter, because X charges far more for posts that contain a link. This covers full URLs (http://, https://, www.) and bare domains like foo.com or foo.io/path. All other platforms keep their links. To share a link on X, post it in a reply or in the account bio.

post/v1/posts

Request body

captionstring required

Caption text for the post

scheduled_atstring date-time nullable

Scheduled date and time for the post. Setting to null or undefined will post instantly.

mediastring[] nullable

Array of media IDs associated with the post. Some platforms require media to publish (youtube, tiktok, instagram, pinterest) — see the create-post endpoint description for the per-platform media requirements and accepted types.

media_urlsstring[] nullable

Array of publicly accesible media URLs associated with the post, will be ignored if media is provided

social_accountsnumber[] required

Array of social account IDs for posting

is_draftboolean nullable

If true will create the post but not process it until it is updated with a scheduled date or processed instantly

processing_enabledboolean nullable

If true will process video files to ensure they post, If false we will skip all video processing

use_queueobject nullable

Automatically schedule the post to the next available queue slot. Cannot be used together with scheduled_at. Pass true to use your saved timezone, or { timezone: "America/New_York" } to override.

Example request

{
  "scheduled_at": "2023-12-31T23:59:59Z",
  "platform_configurations": {
    "instagram": {
      "placement": "story",
      "user_tags": [
        "partner_account",
        "brand"
      ],
      "collaborators": [
        "partner_account"
      ]
    },
    "facebook": {
      "placement": "story"
    }
  }
}

Response

Post created successfully.

idstring required

Unique identifier of the post

captionstring required

Caption text for the post

status'posted' | 'scheduled' | 'processing' | 'failed' required

Current status of the post: scheduled, processing, or posted

scheduled_atobject nullable required

Scheduled date and time for the post

platform_configurationsobject nullable required

Platform-specific configurations for the post

social_accountsnumber[] required

Array of social account IDs associated with the post

account_configurationsobject nullable required

Account-specific configurations for the post

mediaobject nullable required

Array of media URLs associated with the post

created_atstring required

Timestamp when the post was created

updated_atstring required

Timestamp when the post was last updated

is_draftboolean required

If true the post will not be processed until updated

warningsstring[]

Warnings about draft behavior — e.g. platforms that will publish immediately when the draft is sent

Changes