Skip to content

Delete Comment API: Delete a Comment

The Delete Comment API removes a specific comment by its platform comment ID for a connected account. Use it when a comment has been identified through listing or moderation workflows and needs to be removed, rather than hidden or replied to. Before calling, confirm the platform behavior for the target, because deletion, YouTube rejection, and Twitter/X reply deletion are not identical operations.

Platform behavior and limits

This operation applies to comments under Facebook Pages, Instagram Business accounts, LinkedIn posts, and YouTube videos. On Twitter/X it removes only your own reply, and the source contract states a cost of 3 credits for that case. Threads not supported here, so a Threads target needs a different approach rather than this endpoint.

YouTube delete versus reject

Ownership determines the outcome when you delete YouTube comment content. A comment from your own channel is removed outright. If the comment belongs to another viewer but sits on a video your channel owns, outright deletion is not available; the operation instead rejects it, which removes it from public view. That outcome is final, with no restoration or unhide available afterward. Confirm authorship first so the expected result matches what will actually happen.

Request

Send the request shown in the Delete comment request example below. Replace the commentId path value with the platform comment ID to delete, set platform to one of the supported enum values, and set accountId to the Integration ID from list_integrations. Include the x-access-key header with your access key. The worked example uses platform=facebook and accountId=INTEGRATION_ID as placeholders; substitute the real values for the target comment and connected account.

Parameters

All three parameters are required. The commentId must be the platform comment ID, not a post ID or an internal database ID. The platform value determines which platform behavior applies, including the YouTube delete versus reject distinction and the Twitter/X own-reply deletion. The accountId identifies the connected integration to act through, so verify it matches the account that owns or is authorized for the post before calling.

Response

A successful call returns the response shown in the Successful delete comment response example below, with the success field set to true. Treat that response as confirmation for the documented success case only. The source contract does not document additional response fields, error codes, retry behavior, or idempotency behavior, so do not assume them when building error handling around this endpoint.

Checks before and after deletion

Before calling, identify the exact commentId, confirm the platform enum value, and confirm the accountId for the connected account. After calling, check the success response. As an optional reader workflow, you may also re-check the comment through listing to see whether it remains visible, but the source contract does not guarantee listing timing or behavior, so treat that as a supplementary check rather than a required verification step. If the target is on Threads, stop: Threads not supported for this delete operation.

Platform behavior matrix
PlatformBehaviorNotes
facebookDelete commentFacebook Page post comment.
instagramDelete commentInstagram Business post comment.
linkedinDelete commentLinkedIn post comment.
youtubeDelete or rejectOwn channel comments are deleted outright. Another viewer's comment on a channel-owned video is rejected from public view; rejection is permanent with no unhide.
twitterDelete own reply tweetCosts 3 credits per source contract.
threadsNot supportedThreads not supported for this endpoint.

Source contract parity; no native platform API substitution.

Parameters
ParameterLocationRequiredDescription
commentIdpathYesPlatform comment ID to delete
platformqueryYesfacebook, instagram, linkedin, youtube, or twitter
accountIdqueryYesIntegration ID from list_integrations

Exact source input contract.

Frequently asked questions

Can this endpoint delete a Threads comment?

No. The documented platform values are facebook, instagram, linkedin, youtube, and twitter. Threads not supported for this endpoint, so a Threads comment cannot be deleted through this operation.

What happens when you delete YouTube comment content written by someone else?

For a comment authored by your own channel, deletion removes it outright. For another viewer's comment on a video your channel owns, the operation instead rejects it from public view. That rejection cannot be reversed or unhidden.

What does deletion mean on Twitter/X?

On Twitter/X, this operation deletes your own reply tweet. The source contract states a cost of 3 credits for that case.

Delete comment request
DELETE {{API_BASE_URL}}/v1/comments/:commentId?platform=facebook&accountId=INTEGRATION_ID
x-access-key: YOUR_ACCESS_KEY
Successful delete comment response
{
	"success": true
}
Endpoint request 1
DELETE /v1/comments/:commentId?platform=facebook&accountId=INTEGRATION_ID
x-access-key: YOUR_ACCESS_KEY