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_forstring<date-time>

ISO 8601 datetime in UTC when the post should publish, e.g. "2026-04-15T14:30:00Z". Always send UTC — convert from local time in your code if needed. Omit to publish immediately. The timezone field is metadata for display only and does NOT change when the post fires.

scheduled_atstring<date-time>deprecated

DEPRECATED: use scheduled_for instead. scheduled_at was a misnamed legacy field — semantically scheduled_for is the correct English name for "the time the post is scheduled FOR". Still accepted for back-compat but will be removed in v2.

timezonestring

IANA timezone (e.g. "UTC", "America/New_York"). Defaults to "UTC". This is metadata for display in the PostEverywhere web UI — it does NOT change when the post fires. The actual fire time is always determined by scheduled_for. The web app uses this to render schedules in the user's preferred local time.

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_for": "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"
    }
  }
}