Skip to main content
POST
Add a ghost video to a campaign

Authorizations

Authorization
string
header
required

OAuth 2.1 authorization code + PKCE (S256). Tokens are tenant-bound (company_id) and scoped. Discover endpoints via /.well-known/oauth-authorization-server.

Headers

Idempotency-Key
string

Client-chosen key; replaying the same key + body returns the original response, a different body returns 409.

Path Parameters

id
string
required

Body

application/json
platform
enum<string>
required
Available options:
tiktok,
instagram,
youtube,
snapchat,
twitter,
linkedin,
x
videoUrl
string<uri>
required

Public social-video URL whose detected platform must match platform.

Maximum string length: 2048
description
string
Maximum string length: 500
creatorId
string

Optional existing creator to attach to the ghost video.

Required string length: 1 - 200

Response

Ghost video added to the campaign.

data
object
required