comment.received webhook event. Comments work on the default TikTok connection: on a creator connection, only the list of posts with their comment counts works, and the same holds for an account connected before 2026-10-13 until you reconnect it. The endpoints are the shared Comments endpoints, and this page holds what is specific to TikTok.
A public reply costs 1 interaction credit. Reading, hiding, deleting, and liking cost none.
Endpoints
SocialAPI does not send private replies on TikTok:
POST /v1/inbox/comments/{post_id}/{comment_id}/private-reply returns 501 resource.not_supported.
Which accounts have comments
- Default connection only. An account connected on or after 2026-10-13 with
connection_type: "business", or with noconnection_type, has comments. On a creator connection,GET /v1/inbox/commentslists the account’s posts with their comment counts. Every other comment call returns501 resource.not_supported, and nocomment.receivedevent is sent. - Accounts connected before 2026-10-13.
GET /v1/inbox/commentslists the account’s posts with their comment counts. Every other comment call returns501 resource.not_supported, and nocomment.receivedevent is sent, until you reconnect the account: see Connect an account. - Account permissions. Listing comments and replies needs the
comments.readpermission. Replying, commenting on a post, hiding, unhiding, deleting, liking, and unliking needcomments.write. TikTok comments need no other permission. Without the one a call needs, the call returns403 account.permission_missing, anderror.meta.permissionnames it.GET /v1/inbox/commentsnever returns this error: withoutcomments.read, no new posts are added to its list, and removingcomments.readempties the list.
Post and comment IDs
{post_id}is the TikTok video ID. It istargets[].platform_post_idon a post you published through SocialAPI, andidinGET /v1/inbox/comments.platform_idof a comment is{video_id}_{comment_id}, for example7431982715038469413_7432015593081422625.idof a comment is itssapi_cmt_ID. Useidorplatform_idas{comment_id}and ascomment_id.- Bare TikTok comment IDs. Hide, unhide, reply, and list replies need
idor the fullplatform_id. A bare TikTok comment ID such as7432015593081422625returns400 validation.comment_id_invalid, with the value inerror.meta.comment_id. Delete, like, and unlike accept a bare comment ID too.
List posts with comments
GET /v1/inbox/comments lists the account’s TikTok posts with their comment counts. Add min_comments=1 to keep only posts that have comments. The other parameters are in List posts with comments.
- Which posts. The list holds the account’s 20 most recent TikTok posts, plus older posts that were among its 20 most recent posts earlier or whose comments (without
q,order, ormoderation_status) or replies you listed. To read the comments on any other post of the account, callGET /v1/inbox/comments/{post_id}with its video ID. comment_countis TikTok’s count for a post among the account’s 20 most recent posts, and it can trail TikTok. After a post leaves those 20, itscomment_countkeeps its last value and goes up by 1 only for each comment or reply you send on it through SocialAPI. A post that is in the list only because you listed its comments or replies starts at0, and itscomment_countgoes up by 1 only for each comment or reply you send on it through SocialAPI.GET /v1/inbox/comments/{post_id}returns the post’s current comments.like_countis0. Read a post’s likes from Sync videos.thumbnailis a temporary link from TikTok. Download the image if you need it later.
List the comments on a post
GET /v1/inbox/comments/{post_id} lists the comments on one post, in TikTok’s order. account_id is required.
A page can hold fewer comments than
limit while pagination.has_more is true, because TikTok leaves some comments out of a page. Follow next_cursor until has_more is false.
The fields on TikTok:
capabilities on TikTok:
Hidden comments
TikTok leaves hidden comments out of its comment list. SocialAPI adds a hidden comment back at the end of the first page of results, withis_hidden: true, when all of these hold:
- The comment is a top-level comment that appeared in a
GET /v1/inbox/comments/{post_id}response sent withoutq,order, ormoderation_status(or with their defaults) before it was hidden. - You hid it with
POST /v1/inbox/comments/{post_id}/{comment_id}/hide, or with the MCP toolsocial_api_hide_commentand itspost_id. - The first page of results has
pagination.has_more: false. - The request sends no
q, andorderandmoderation_statusare absent or set torecentandpublished.
limit. Send limit=30, the largest page TikTok returns: if the first page still has pagination.has_more: true, no hidden comment is listed on any page.
A comment hidden in the TikTok app, a reply you hid, and a comment hidden with social_api_moderate_comment or with social_api_hide_comment without post_id are not added back. A comment unhidden in the TikTok app or deleted stops being added. Keep a comment’s id or platform_id when you hide it: where it is not listed, that ID is how you unhide it.
List the replies to a comment
GET /v1/inbox/comments/{post_id}/{comment_id}/replies lists the replies to one comment, in the same shape as comments. {comment_id} is the comment’s id or full platform_id.
limit defaults to 10, and TikTok returns at most 30 replies per page. TikTok does not list the replies to a hidden comment.
Reply to a comment or comment on a post
POST /v1/inbox/comments/{post_id} with comment_id replies to that comment as the connected account. Without comment_id, it adds a top-level comment to the post.
comment_id in the response is the new comment’s sapi_cmt_ ID.
- Credit. A reply or a comment on the post costs 1 interaction credit. When the plan’s interaction allowance is used up, the call returns
429 validation.interaction_limit_exhausted. Avalidation.*error, such as400 validation.comment_id_invalid, gives the credit back: see When a credit comes back. - Text over 1,200 characters. TikTok refuses the reply, and the credit stays spent.
error.messagecarries TikTok’s reason: see Errors. - Repeated text. TikTok can hide comments it flags as spam, such as many near-identical replies posted in a short time. Vary the text of automated replies.
Hide and unhide a comment
POST /v1/inbox/comments/{post_id}/{comment_id}/hide hides a comment another person wrote. DELETE on the same path, with account_id as a query parameter, unhides it. Both return { "success": true } and cost no credit.
- Who can be hidden. Comments other people wrote.
can_hideisfalseon the connected account’s own comments, and TikTok refuses to hide them.error.messagecarries TikTok’s reason: see Errors. Delete them instead. - Unhide can stay hidden. TikTok can keep a comment hidden after a successful unhide when its own moderation, the person’s privacy settings, or another TikTok filter hides it. List the post’s comments to check.
- Finding a hidden comment again. See Hidden comments.
Delete a comment
DELETE /v1/inbox/comments/{post_id}/{comment_id}?account_id={account_id} deletes a comment the connected account wrote. It returns { "success": true }, costs no credit, and cannot be undone.
can_delete is false on other people’s comments, and TikTok refuses to delete them. error.message carries TikTok’s reason: see Errors. Hide those comments instead.
Like and unlike a comment
POST /v1/inbox/comments/{post_id}/{comment_id}/like likes a comment as the connected account, with account_id in the body. DELETE on the same path, with account_id as a query parameter, removes the like. Both return { "success": true } and cost no credit. can_like is true on every TikTok comment.
What you cannot do on TikTok
- Private replies. SocialAPI does not send private replies on TikTok: the call returns
501 resource.not_supported. Reply publicly instead. - Images. SocialAPI sends replies as text only, and listed comments carry only their text, not an attached image.
- Editing a comment. SocialAPI has no endpoint for it. Delete the comment and post a new one.
- Deleting another person’s comment. TikTok refuses the call. Hide the comment instead.
- Hiding the connected account’s own comment. TikTok refuses the call. Delete the comment instead.
- Replies to a hidden comment. TikTok does not list them. Unhide the comment first.
- Comment actions on a creator connection. Every comment call except
GET /v1/inbox/commentsreturns501 resource.not_supported. Connect the account with the default connection: see Creator connection.
Comment events
SocialAPI sendscomment.received when another person comments on, or replies under, a post of the connected TikTok account. The payload is the shared Interaction shape. On TikTok:
- IDs.
idis the comment’ssapi_cmt_ID, the sameidthatGET /v1/inbox/comments/{post_id}returns.platform_post_idis the TikTok video ID.post_idandpermalinkare not set, andmetadataisnull. - Author.
author.idis TikTok’s unique identifier for the person.author.name,author.username, andauthor.avatar_urlcome from the comment. - Content.
content.textis the comment text. - Raw payload.
raw_payloadholds TikTok’s notification. - Timing.
comment.receivedcan arrive up to 5 minutes after the comment is posted, because TikTok reports new comments to apps with that delay. - Not sent. Comments written by the connected account, deletions, and changes to a comment’s visibility. A comment deleted within 5 minutes of being posted can produce no event. Read
GET /v1/inbox/comments/{post_id}to catch comments the events missed. - The same TikTok account connected more than once. When more than one connected account holds the same TikTok account, each one with the
comments.readpermission receives its own event. An account withoutcomments.readreceives none.
comment.received.
Limits
Errors and debugging
Check these in order when a TikTok comment call fails:501 resource.not_supported. The call is a private reply, or the account is a creator connection or was connected before 2026-10-13 (on those, onlyGET /v1/inbox/commentsworks).403 account.permission_missing. The account lackscomments.readorcomments.write.error.meta.permissionnames it.400 validation.comment_id_invalid. A bare TikTok comment ID on hide, unhide, reply, or list replies. Send the comment’sidor fullplatform_id.401 platform.tiktok.auth,403 account.reconnection_required,401 platform.tiktok.unauthorized. TikTok’s authorization for the account ended or was refused: see When TikTok authorization ends.403 platform.tiktok.40001,403 platform.tiktok.40118,403 platform.tiktok.40125. The account’s authorization lacks a scope the call needs. Reconnect the account.404 resource.not_found. The post or the comment does not exist on TikTok, for example because it was deleted.400 platform.tiktok.40000,400 platform.tiktok.40002. TikTok refused a parameter.error.messagecarries TikTok’s reason.429 platform.tiktok.rate_limit,429 validation.interaction_limit_exhausted. TikTok’s request limit, or your plan’s interaction allowance.503 platform.tiktok.api_error, or aplatform.tiktok.*code not listed above. TikTok returned no usable answer, or refused the call for another reason.error.messagedescribes the failure, with TikTok’s reason when TikTok gave one. See Errors.
Scopes
On TikTok’s consent screen, the connected account grants
comment.list for reading comments and comment.list.manage for replying, hiding, liking, and deleting: see TikTok scopes.
Use from an AI agent
social_api_private_reply_to_comment returns resource.not_supported on TikTok. The full list is in MCP tools.
Related
- TikTok API: capabilities, connection types, mentions, and scopes for TikTok
- TikTok publishing: publish the videos and photo posts that receive these comments
- Comments: the shared comment endpoints and fields on every platform
- Webhook events: the
comment.receivedpayload - Account permissions:
comments.readandcomments.write - Plans and usage: what costs an interaction credit