---
title: "Reply to a comment or a Google review"
method: POST
path: "/v1/comments/reply"
---

# Reply to a comment or a Google review

`POST /v1/comments/reply`

## Request

- Base URL: `https://api.breakreach.com`
- URL: `https://api.breakreach.com/v1/comments/reply`
- Auth: HTTP bearer

Replies to a comment on a published post. Supported: Instagram, Facebook, Threads, X, and Google Business Profile reviews (platform googlebusiness, commentId = the review id). A Google review takes one reply from the business, so replying again replaces it; replies take up to 4,096 bytes, only work on verified locations, and Google moderates them (status pending until approved). YouTube is not listed yet: its comments need a restricted Google permission (youtube.force-ssl) that is not available to every account.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `accountId` string, required
  - `platform` 'instagram' | 'facebook' | 'threads' | 'x' | 'googlebusiness', required
  - `commentId` string, required
  - `message` string, required: Google reviews: up to 4,096 bytes
  - `workspace` string

## Response `200`

OK

- object
  - `ok` boolean
  - `replyId` string
  - `status` 'pending' | 'approved': Google reviews: pending while Google moderates the reply

## Other responses

- `400`: Missing field, unsupported platform, or a Google review reply over 4,096 bytes
- `401`: Missing, invalid or expired API key
- `402`: No active Breakreach subscription or trial
- `403`: Not a member of the requested workspace
- `404`: Account, review or workspace not found
- `409`: A request with this Idempotency-Key is still running: retry after Retry-After seconds to get its response
- `422`: This Idempotency-Key was already used with a different request in the last 24 hours
- `502`: The platform rejected the reply, and why (for Google: unverified location, or a content policy reason; for Threads: Meta hasn't given Breakreach access to replies yet, or the connection expired)

---

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