Skip to main content
POST
Publish a video to social media

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

Path Parameters

id
string
required

Unique video identifier

Example:

"vid_abc123def456"

Body

application/json
destination
enum<string>
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.

Available options:
youtube,
youtube_shorts,
linkedin,
x,
instagram_post,
instagram_reel,
instagram_story,
facebook_post,
facebook_story,
facebook_reel
title
string
required

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

Minimum string length: 1
accountId
string

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

description
string

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

export
object

Settings of the export to upload, as POST /v1/videos/{id}/exports takes them. A finished or running export with these settings is reused; otherwise one is started. Defaults to 1080p, 30 fps, no burned-in subtitles, 1x.

privacy
enum<string>

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.

Available options:
public,
unlisted,
private
scheduledAt
string

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.

trialReel
enum<string>

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.

Available options:
manual,
performance
uploadCaptions
boolean

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

Response

Publish queued

publication
object
required