Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.dohoo.ai/llms.txt

Use this file to discover all available pages before exploring further.

The TikTok publish endpoint lets you post videos to a connected TikTok account directly through the Dohoo API. Unlike the other platform-specific endpoints, TikTok publishing uses the shared social post endpoint — you specify "platform": "tiktok" in the request body to route the content to TikTok. Pass your connection ID, the uploaded video file reference, and an optional caption to get your video live.

​
Endpoint

POST https://dohoo.ai/api/social/post

​
Request headers

HeaderRequiredDescription
X-API-Key✅Your Dohoo API key
Content-Type✅Must be application/json

​
Request body

FieldTypeRequiredDescription
platformstring✅Must be "tiktok"
connectionIdstring✅The ID of the TikTok connection to publish from
fileIdstring✅The ID of the uploaded video file
captionstring❌Caption for the TikTok post. Supports hashtags and mentions

​
Example request

curl -X POST https://dohoo.ai/api/social/post \
  -H "X-API-Key: dh_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "tiktok",
    "connectionId": "conn_tiktok_001",
    "fileId": "abc123",
    "caption": "Your TikTok caption #trending"
  }'

​
Example response

{
  "success": true,
  "platform": "tiktok",
  "postId": "7234567890123456789",
  "connectionId": "conn_tiktok_001",
  "status": "published",
  "publishedAt": "2025-01-15T14:20:00Z",
  "url": "https://www.tiktok.com/@yourhandle/video/7234567890123456789"
}
TikTok only supports video content through this endpoint. Image posts are not supported. Attempting to publish a non-video file will return a 400 Bad Request error.
Videos must be between 3 seconds and 10 minutes in length. TikTok may reject videos outside this range during processing, even if the API initially accepts the request.
For best results on TikTok, use vertical video (9:16 aspect ratio) at a minimum resolution of 1080×1920. Front-load engaging content in the first 2–3 seconds to reduce drop-off rates.