ORorshot
Social

Publish to Social

Changed on

Publish images or videos directly to connected social accounts

post/social/publish

Request

  • Base URL
    https://api.orshot.com/v1
  • URL
    https://api.orshot.com/v1/social/publish
  • Auth
    HTTP bearer

Request body

contentstring

Caption/text for the post (max 5000 characters). Each platform has a lower limit. See Caption limits

media_urlstring

URL of the image or video to publish

statusstring

published (default), draft or scheduled — see above

scheduled_forstring

ISO 8601 timestamp, at least 60 seconds ahead. Required with status: "scheduled", invalid otherwise

timezonestring

IANA timezone string for scheduling (e.g., "America/New_York", "Europe/London")

platformOptionsobject

Per-account options keyed by account ID (see below). platform_options also accepted

tiktokSettingsobject

Root-level TikTok options for photo posts. autoAddMusic: true asks TikTok to add recommended music. photoCoverIndex picks which image is the cover (default 0)

Response

Successful response

object required

Changes