Sign in
Social

Publish to Social

Publish images or videos directly to connected social accounts

post/social/publish

Request body

contentstring

Caption/text for the post (max 5000 characters)

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 carousels, { "autoAddMusic": true } asks TikTok to add recommended music.

Response

Successful response

object required

Changes

Changed in 2 of the 8 revisions of this API.18

  • b2284a52aaad6See the full diff
    • ○

      added the media type application/json for the response with the status 401

      response-media-type-added

    • ○

      added the media type application/json for the response with the status 429

      response-media-type-added

    • ○

      added the non-success response with the status 400

      response-non-success-status-added

    • ○

      added the non-success response with the status 403

      response-non-success-status-added

    • ○

      added the non-success response with the status 404

      response-non-success-status-added

    • ○

      added the non-success response with the status 500

      response-non-success-status-added

  • fab85c44ee7812See the full diff
    • ●

      removed the request property isDraft

      request-property-removed

    • ○

      added the new optional request property scheduled_for

      new-optional-request-property

    • ○

      added the new optional request property status

      new-optional-request-property