---
title: "Hide or unhide an ad comment"
method: POST
path: "/v1/ads/{adId}/comments/{commentId}/hide"
tags: ["Ad Accounts"]
---

# Hide or unhide an ad comment

`POST /v1/ads/{adId}/comments/{commentId}/hide`

Hide or restore a TikTok ad comment. Send hidden=true to hide it or hidden=false to make it public again. Identity and video item ID are not required; no identity lookup is performed.

Requires Ads access. The ad is resolved within the caller's accessible profiles.
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 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.

## Path parameters

- `adId` string, required
- `commentId` string, required

## Query parameters

- `since` string, date
- `until` string, date

## Request body

- object
  - `hidden` boolean, required — True to hide the comment; false to restore it.

## Response `200`

Comment action completed.

- object
  - `status` 'success', required
  - `commentId` string, required — ID of the created reply or moderated comment.
  - `hidden` boolean — The requested visibility state.

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `403` — Ads access or the required TikTok comment capability is unavailable.
- `404` — Ad is inaccessible or the comment was not found on this ad in the selected date window.
- `422` — TikTok Ads connection is unavailable.
- `501` — Moderation on this route supports TikTok. Use the inbox comment routes for Meta.
- `502` — TikTok rejected the request or was unavailable. Inspect platformError for its code and message.

## Changes

- **2026-09-16** `3e6ddf2a99ea` — 1 info
  - added the optional property `details/budgetScope` to the response with the `400` status
- **2026-09-15** `0dba7d004d75` — 2 info
  - added the optional property `details/quotaExhausted` to the response with the `400` status
  - added the optional property `details/quotaScope` to the response with the `400` status
- **2026-09-09** `222e3a38a382` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/ads/:adId/comments/:commentId/hide/post.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) · [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/106013ac73b8?raw)