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; 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.

Available options:
youtube,
youtube_shorts,
linkedin,
x
title
string
required

Video title on YouTube. On LinkedIn and X 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 and X.

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. X: public only.

Available options:
public,
unlisted,
private
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