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
description
string

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

export
object

Settings of the completed export to upload, as passed to POST /v1/videos/{id}/exports. 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
Last modified on October 6, 2026