Ad Accounts

Reply to an ad comment

Changed on

Reply to a first-level TikTok ad comment. Replies to replies are rejected. The response commentId identifies the new reply.

This operation is not idempotent; do not blindly retry an uncertain response.

Requirements

  • Requires Ads access. The ad is resolved within the caller's accessible profiles.
  • Requires a TT_USER or CUSTOMIZED_USER identity with comment-management permission.

Identity resolution

Unknown identity and video item fields are resolved only when needed for this action, then persisted for reuse. Comment-specific fields take precedence.

  • 404 ad_not_found: TikTok no longer returns the ad needed to resolve identity. Check deletion or archival in TikTok Ads Manager. Listing can still succeed.
  • 403 feature_not_available: unsupported or unavailable identity.
  • 403 insufficient_permissions: denied access to ad details, with reconnect guidance and the upstream platformError.

Comment verification

Before moderation, Zernio verifies that the comment belongs to this ad using TikTok's ad-group comment listing.

  • The default search window is the last 30 days.
  • Use since/until for older comments, with at most 30 days between the dates.
  • Lookups scan at most 2,000 ad-group comments; narrow the date window if exceeded.

Meta

Meta returns 501 feature_not_available with guidance to use the existing inbox comment endpoints and the account/post IDs from GET /v1/ads/{adId}/comments.

post/v1/ads/{adId}/comments/{commentId}/reply

Request

Path parameters

adIdstring required

Internal Zernio ad ID or indexed platform ad ID.

commentIdstring required

TikTok comment ID from the ad comment listing.

Query parameters

sincestring date

Start date of the comment lookup window. Defaults to 30 days before until.

untilstring date

End date of the comment lookup window. Defaults to today in UTC.

Request body

textstring required

Non-empty reply text.

Response

Comment action completed.

status'success' required
commentIdstring required

ID of the created reply or moderated comment.

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status