API ReferencePosts
Post to TikTok
Creates a TikTok video or photo post with privacy level, comment/Duet/Stitch settings, and commercial-content disclosure. Check GET /v1/channels/{id}/tiktok/creator-info for the privacy levels the account allows. The schedule field works like createPost. Send an Idempotency-Key header to make retries safe.
Authorization
api-key AuthorizationBearer <token>
Workspace API key (nim_live_...)
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://example.com/v1/posts/tiktok" \ -H "Content-Type: application/json" \ -d '{ "channelId": "123e4567-e89b-12d3-a456-426614174000", "mediaIds": [ "string" ], "privacyLevel": "PUBLIC_TO_EVERYONE" }'{ "id": "123e4567-e89b-12d3-a456-426614174000", "channelId": "123e4567-e89b-12d3-a456-426614174000", "content": "Launching something new today 🚀", "title": null, "contentType": "POST", "status": "SCHEDULED", "scheduledAt": "2026-08-01T09:00:00.000Z", "publishedAt": null, "createdAt": "2026-07-05T10:00:00.000Z", "mediaIds": [ "string" ]}Empty