WIwithchima
Videos

Publish a video to social media

Changed on

Posts the video to one of your connected social accounts: YouTube, YouTube Shorts, LinkedIn, X, Instagram (post, reel or story) or Facebook (post or story). This posts under your own account, so check the destination, text and privacy before calling it. It uploads an export with the export settings, reusing a finished or running one or starting one, so there is no need to export first. The account must already be connected in Tella (Settings → Connections, or Share → Publish in the editor); a 403 means it isn't, or that the plan doesn't include the export's resolution or frame rate. With several accounts connected for a destination, pass accountId from GET /v1/social-accounts; without it the oldest connected one posts. To post to several accounts, call once per account. TikTok can only be published from the Tella app, because TikTok requires its consent form. Returns 202 with a queued publication, which stays queued while the export renders; poll GET /v1/videos/{id}/publish for the result. To post later, pass scheduledAt: the publication stays queued with that scheduledAt until then, and DELETE /v1/videos/{id}/publish cancels it before it goes out. One publish per destination and account runs at a time. Requires edit access to the video.

post/v1/videos/{id}/publish

Request

Path parameters

idstring required

Unique video identifier

Example:vid_abc123def456

Request body

accountIdstring

Which of your connected accounts to post with, from GET /v1/social-accounts. Defaults to the oldest connected account for the destination.

descriptionstring

YouTube description, or the post text on LinkedIn, X, Instagram and Facebook.

destination'youtube' | 'youtube_shorts' | 'linkedin' | 'x' | 'instagram_post' | 'instagram_reel' | 'instagram_story' | 'facebook_post' | 'facebook_story' | 'facebook_reel' required

Where to post. YouTube Shorts must be vertical or square and at most 3 minutes; Facebook Stories vertical and at most 60 seconds; Facebook Reels vertical and at most 90 seconds; Instagram Stories at most 60 seconds and 100 MB; Instagram posts and reels at most 15 minutes and 300 MB; no Instagram destination takes a 4K export; LinkedIn at most 30 minutes and 500 MB. Instagram, Facebook Stories and Reels and LinkedIn need at least 3 seconds. YouTube takes at most 15 minutes from a channel that isn't verified; X at most 20 minutes, or 125 with Premium or a checkmark. Stories show no text. The Facebook and Instagram destinations publish through one Facebook connection.

privacy'public' | 'unlisted' | 'private'

YouTube: private (default), unlisted or public. LinkedIn: private (connections only, default) or public. Facebook posts: private (only people who manage the Page, default), unlisted (anyone with the link) or public. Facebook posts, stories and reels go to the default Page set in Settings → Connections, else the first Page the account manages. Instagram destinations likewise go to the default Instagram account. Every other destination: public only.

scheduledAtstring

When to post, as an ISO 8601 time with a timezone, e.g. 2026-10-20T15:00:00Z; at most 30 days ahead. The video is exported now, so later edits aren't in the post. Omit to post as soon as the export is ready.

titlestring required

Video title on YouTube. On LinkedIn, X, Instagram and Facebook it is the post text when description is empty.

trialReel'manual' | 'performance'

Instagram Reels only: share it as a trial reel, shown to people who don't follow the account first. manual: it stays a trial until the user shares it with followers in the Instagram app. performance: Instagram shares it with followers if it performs well. Omit for an ordinary reel.

uploadCaptionsboolean

YouTube only: upload the transcript as a caption track (default true). Skipped when the export has burned-in subtitles.

Response

Publish queued

Changes

  • a15e5c06bd15Revision changes
    • info

      added the new optional request property

  • 0cc3fcd307adRevision changes
    • info

      added the new 0.8 enum value to the request property /

    • info

      added the new 0.9 enum value to the request property /

    • info

      added the new 1.1 enum value to the request property /

    • info

      added the new 1.2 enum value to the request property /

    • info

      added the new 1.3 enum value to the request property /

    • info

      added the new 1.35 enum value to the request property /

    • info

      added the new 1.7 enum value to the request property /

    • info

      added the new 2.5 enum value to the request property /

    • info

      added the new facebook_reel enum value to the request property