Skip to main content
POST
Post a video

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string

A UUID. When present, deduplicates repeat submissions. See /api-reference/idempotency.

Path Parameters

id
string
required

Body

application/json
connection_ids
string<uuid>[]
required

Accounts to post to, from GET /v1/social-connections

Minimum array length: 1
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
media_type
enum<string>
default:video
required

carousel posts a slideshow's slides (TikTok and Instagram only)

Available options:
video,
carousel
settings
object
required

Per-platform options; omitted ones use their defaults

caption
string

The caption for every platform without its own. Omit to use the video's caption and hashtags.

Maximum string length: 4000
captions
object

A platform's own caption, checked against that platform's limits

scheduled_for
string<date-time>

Post at this time (at least a minute ahead, up to a year). Omit to post now.

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$

Response

Success

data
object
required