Posts

Publish to a TikTok creator account through POST /v1/posts.

Cross-platform flow: Media guide.

Supported formats

`mediaKind`	Supported	Notes
`video`	Yes	Exactly one `mediaUrls` entry
`image`	Yes	One image URL (host must be verified with TikTok)
`multi-image`	Yes	2–35 image URLs (photo post)
`text` / `stories`	No	`UNSUPPORTED_MEDIA_KIND`

Features

Feature	Supported	Notes
Thread / quote	No
Schedule	Yes	`scheduledFor` + `timezone`
Privacy	Yes	Destination `privacyLevel` required
Description	Photo only	Optional `destinations[].description`
Remote delete	No

Privacy (required)

TikTok does not allow a silent default. Every TikTok destination must include privacyLevel:

Value	Meaning
`PUBLIC_TO_EVERYONE`	Everyone (audited apps / allowed creators)
`MUTUAL_FOLLOW_FRIENDS`	Friends
`FOLLOWER_OF_CREATOR`	Followers
`SELF_ONLY`	Only me (required for unaudited clients)

Onepostly rejects privacyLevel values not allowed for that creator. Check available options via the TikTok creator-info connection endpoint when needed.

privacyLevel is TikTok-only. Sending it on another platform returns 400 VALIDATION_ERROR.

Create (video)

curl -X POST https://api.onepostly.com/v1/posts \
  -H "x-api-key: op_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Launch clip #fyp",
    "mediaKind": "video",
    "mediaUrls": ["https://cdn.example.com/clip.mp4"],
    "destinations": [
      {
        "connectionId": "YOUR_TIKTOK_CONNECTION_ID",
        "privacyLevel": "SELF_ONLY"
      }
    ]
  }'

Response: 202 with status: "queued". When published, externalPostId is the TikTok post_id when publicly available, otherwise the publish_id.

Photo / carousel

{
  "text": "Short title",
  "mediaKind": "multi-image",
  "mediaUrls": [
    "https://cdn.example.com/1.jpg",
    "https://cdn.example.com/2.jpg"
  ],
  "destinations": [
    {
      "connectionId": "YOUR_TIKTOK_CONNECTION_ID",
      "privacyLevel": "SELF_ONLY",
      "description": "Longer caption with #hashtags"
    }
  ]
}

Photo posts require a verified URL property on your TikTok app for the media host.

Limits

Limit	Value
Video size	Up to 4 GB (TikTok)
Photo formats	JPEG / WebP
Unaudited Direct Post	Private only + creator caps