Inbox

TikTok supports DMs and comments for accounts connected through TikTok's Business app, which every new TikTok connection uses. An account still connected through TikTok's developer app gets a 400 with code PLATFORM_LIMITATION for both.

Direct messages

TikTok decides which accounts can use DMs:

• The account is a TikTok Business Account. TikTok refuses personal accounts.
• The account's sign-up region is outside the EEA, Switzerland and the UK.
• The account accepts DMs, from everyone or by accepting message requests. Otherwise TikTok sends no webhook for incoming messages.

You can only reply: TikTok does not let a business start a conversation. After the user's last message, TikTok accepts up to 10 messages within 48 hours, and a send outside that window fails with TikTok's error.

Reply with Send message (POST /v1/inbox/conversations/{conversationId}/messages). A message is text or one image, never both: a request with message and an attachment returns 400 with code PLATFORM_LIMITATION.

Comments

Comment management does not need a Business Account.

• Read comments: GET /v1/inbox/comments/{postId} (TikTok video id). Each top-level comment includes up to three inline replies; pass commentId to page the full reply list for one comment.
• Post a comment, reply, and like, hide or unhide any comment. Delete works on your own comments and replies.
• Pin and unpin a top-level comment, as shown below.

Pin and unpin comments

Pin a top-level comment:

curl -X POST https://zernio.com/api/v1/inbox/comments/{postId}/{commentId}/pin \
  -H "Authorization: Bearer $ZERNIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "66b2e19d8c3f5a7e9d0b1c2d"
  }'

Unpin a previously pinned comment:

curl -X DELETE "https://zernio.com/api/v1/inbox/comments/{postId}/{commentId}/pin?accountId=66b2e19d8c3f5a7e9d0b1c2d" \
  -H "Authorization: Bearer $ZERNIO_API_KEY"

Webhooks

TikTok supports comment.received, message.received and message.sent webhooks. Comment events include only the author id (no username, picture, or owner flag).