Videos

Publish a video to social media

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. One publish per destination and account runs at a time. Requires edit access to the video.

post/v1/videos/{id}/publish

Request

  • Base URL: https://api.tella.com
  • URL: https://api.tella.com/v1/videos/{id}/publish
  • Auth: HTTP bearer

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 and X.

destination'youtube' | 'youtube_shorts' | 'linkedin' | 'x' required

Where to post. YouTube Shorts must be vertical or square and at most 3 minutes; LinkedIn at most 30 minutes and 500 MB, and 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.

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

YouTube: private (default), unlisted or public. LinkedIn: private (connections only, default) or public. X: public only.

titlestring required

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

uploadCaptionsboolean

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

Response

Publish queued

Changes

No recorded changes to this operation across all 1 revision of this API.