Skip to content

Google Business Profile review reply API

Use the Google Business Profile review reply API to post or update the business owner reply on a specific Google Business Profile review. A review has a single owner reply, so sending a new reply replaces any existing reply rather than adding a second one. The reply is published publicly under the review on Google, and replying costs 1 credit.

What this operation does and single-reply overwrite behavior

This operation posts the business owner reply to a Google Business Profile review. Because a review has a single owner reply, replying again overwrites the previous one. Before calling the endpoint, obtain the integration ID for the location from list_integrations to use as accountId, and obtain the review identifier from list_reviews to use as reviewId. The supported platform value is googlebusiness. Check that the reviewId belongs to the location identified by accountId before sending, because the request targets one specific review. After a successful call, verify the returned reply text and updatedAt value match the text you sent and the time the reply was updated.

Prerequisites: list_integrations and list_reviews

Start by listing integrations to find the integration ID of the Google Business Profile location, then list reviews for that location to find the review you want to answer. Use the integration ID as accountId and the review's ID as reviewId. If you cannot find the review in list_reviews output, do not guess a reviewId; re-check the location selection and fetch the review list again. Keep the exact identifiers from those responses when building the reply request.

Request: POST {{API_BASE_URL}}/v1/reviews/reply with exact body contract

Send a POST request to the reply endpoint with the x-access-key header and a JSON body containing platform, accountId, reviewId, and text. Set platform to googlebusiness, accountId to the integration ID from list_integrations, reviewId to the review ID from list_reviews, and text to the owner reply you want published. The text field replaces any existing reply, so treat every call as an update to the single visible owner reply. The worked request example below shows the exact headers and body fields, and the body parameters table lists each field with its type and requiredness.

Response: success, reply.text, reply.updatedAt

A successful response returns success set to true, along with a reply object containing the published text and an updatedAt timestamp. Compare reply.text with the text you sent and check reply.updatedAt to confirm when the reply was updated. If the response does not show the expected text, do not assume the reply was published; inspect the returned fields and retry only after confirming the request parameters. The worked response example below shows the exact response shape.

Body parameters
ParameterTypeRequiredDescription
platformstringYesgooglebusiness
accountIdstringYesIntegration ID of the location from list_integrations
reviewIdstringYesReview ID from list_reviews
textstringYesThe owner reply text (replaces any existing reply)

Exact source contract; all fields required.

Reply to a Google Business Profile review — request
POST {{API_BASE_URL}}/v1/reviews/reply
x-access-key: YOUR_ACCESS_KEY
Content-Type: application/json

{
  "platform": "googlebusiness",
  "accountId": "INTEGRATION_ID",
  "reviewId": "AbFvOqlccRi2DR...",
  "text": "An example comment."
}
Reply to a Google Business Profile review — response
{
	"success": true,
	"reply": {
		"text": "An example comment.",
		"updatedAt": "2026-07-14T10:05:00.000Z"
	}
}
Contract example 1
POST /v1/reviews/reply
x-access-key: YOUR_ACCESS_KEY
Content-Type: application/json
Contract example 2
{
	"platform": "googlebusiness",
	"accountId": "INTEGRATION_ID",
	"reviewId": "AbFvOqlccRi2DR...",
	"text": "An example comment."
}