Skip to main content
POST
cURL
All target accounts must match the requested source. Idempotency replay also validates the stored source and account set; source or set conflicts return 409. Media presign still depends on Zernio and is not an official-only upload path. provider is required: tiktok_direct or zernio. It constrains the operation and never rewrites the stored source. Missing or unknown values return 400 invalid-provider. Use an OmniMux user access token and New-Api-User, not an sk- key. Inspect success as well as HTTP status; some upstream failures return HTTP 200 with success:false.

Authorizations

Authorization
string
header
required

OmniMux user access token, not an sk- API key.

New-Api-User
string
header
required

Current authenticated user ID.

Headers

Idempotency-Key
string

Replay must match both source and account set. X-Idempotency-Key is also accepted.

Body

application/json
provider
enum<string>
required

Required expected source; never changes the stored account or post provider.

Available options:
tiktok_direct,
zernio
account_ids
integer<int64>[]
required

Owned OmniMux account IDs, all belonging to the requested source. Official publishing supports one account.

Minimum array length: 1
content
string

Caption. Use content, not text.

publish_now
boolean
default:true
scheduled_for
string

Setting this makes publish_now false.

timezone
string
queued
boolean
default:false
media_items
object[]

Official TikTok requires media. Existing provider-specific media and scheduling behavior applies.

Response

Check success before reading data. Generic upstream errors may use HTTP 200 with success:false.

success
enum<boolean>
required
Available options:
true
data
object
required