Skip to main content
POST
Add a ghost handle 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,
facebook,
twitter,
linkedin,
x
handle
string
required

Social handle, with or without a leading @.

Required string length: 2 - 60
description
string
Maximum string length: 500
creatorId
string

Optional existing creator to attach to the ghost handle.

Required string length: 1 - 200

Response

Ghost handle added to the campaign.

data
object
required