Skip to main content

CreatePostRequest

contentstringrequired

The text content of the post

account_idsinteger[]required

Array of social account IDs to post to (from list accounts)

Possible values: >= 1

scheduled_atstring<date-time>

ISO 8601 datetime to schedule the post. Omit to publish immediately.

timezonestring

IANA timezone (e.g. America/New_York)

Default value: UTC
media_idsstring<uuid>[]

Array of media UUIDs to attach (from upload media)

platform_content object

Platform-specific content overrides and settings. Use the platform key (instagram, tiktok, youtube, linkedin, x, facebook, threads) as the object key.

instagram object
contentstring

Override caption for Instagram

contentTypestring

Instagram content type. Videos default to Reels if not specified.

Possible values: [Post, Story, Reels, Trial Reel]

settings object
altTextstring

Accessibility alt text for the image

coverPhotoTimestampnumber

Timestamp in seconds for video cover photo

tiktok object
contentstring

Override caption for TikTok

settings object
privacyLevelstring

TikTok video privacy level

Possible values: [PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, SELF_ONLY]

allowCommentsboolean
Default value: true
allowDuetboolean
Default value: true
allowStitchboolean
Default value: true
youtube object
contentstring

Override description for YouTube

settings object
titlestring

YouTube video title (required for YouTube)

privacyStatusstring

Possible values: [public, unlisted, private]

Default value: public
tagsstring[]

YouTube video tags

linkedin object
contentstring

Override text for LinkedIn

x object
contentstring

Override text for X (Twitter). Max 280 characters.

facebook object
contentstring

Override text for Facebook

threads object
contentstring

Override text for Threads

CreatePostRequest
{
  "content": "string",
  "account_ids": [
    0
  ],
  "scheduled_at": "2024-07-29T15:51:28.071Z",
  "timezone": "UTC",
  "media_ids": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ],
  "platform_content": {
    "instagram": {
      "content": "string",
      "contentType": "Post",
      "settings": {
        "altText": "string",
        "coverPhotoTimestamp": 0
      }
    },
    "tiktok": {
      "content": "string",
      "settings": {
        "privacyLevel": "PUBLIC_TO_EVERYONE",
        "allowComments": true,
        "allowDuet": true,
        "allowStitch": true
      }
    },
    "youtube": {
      "content": "string",
      "settings": {
        "title": "string",
        "privacyStatus": "public",
        "tags": [
          "string"
        ]
      }
    },
    "linkedin": {
      "content": "string"
    },
    "x": {
      "content": "string"
    },
    "facebook": {
      "content": "string"
    },
    "threads": {
      "content": "string"
    }
  }
}