v1Resources/Reviews/postReply to a review
Reply to a review
Posts the owner reply to a review, or replaces it: a review has one reply, so a second call edits the first (Google updates it; on Facebook our reply comment is edited). pushed: false means the reply isn't live yet: either the platform accepted it and is still publishing it (status pending), or the platform has no reply API and it's saved in Synup only. Fails with 422 if the review can't be replied to or the platform refused it; retryable says whether trying again can succeed.
post
reviews:write/api/v1/reviews/replyRequest body
reviewIdstringrequired
The review to reply to. Required.
textstringrequired
The reply text to post. Required.
Response
dataobjectoptional
okbooleanoptional
Whether the reply was accepted.
pushedbooleanoptional
Whether the reply is live on the source platform. False while the platform is still publishing it (status pending), or when the platform has no reply API and the reply is saved in Synup only.
statusstring (posted | pending | failed | draft)optional
One of: posted, pending, failed, draft.
externalReplyIdstringoptional
The reply's id on the source platform, or null.
Errors
400The request is missing a required parameter or is otherwise malformed.
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
404The resource wasn't found, or doesn't belong to your agency.
422The request is missing a required parameter or is otherwise malformed.
429Too many requests. Retry after the number of seconds in the Retry-After header.
post/api/v1/reviews/reply
Your API key
Request body*
{
"data": {
"ok": true,
"pushed": true,
"status": "posted",
"externalReplyId": "ext_reply_123",
"retryable": null
}
}Guides that use this endpoint
- How to Build a Reputation Management PlatformArchitecture and API calls for a multi-client reputation management platform on Synup: review ingestion, reply workflows, invites, widgets and reporting.
- How to Add Local Marketing Features to Your SaaSAdd listings management, reviews, Google posts, profile analytics, rank tracking and AI visibility to a SaaS product with the Synup API, tenant by tenant.
- How to Build an AI Agent for Local SEOBuild an AI agent that audits and fixes listings, tracks local rankings, checks AI visibility and drafts review replies with Synup's MCP server or REST tools.
- How to Build an AI Agent That Responds to ReviewsBuild an AI agent that drafts and posts review replies, with rating-based guardrails, human approval for negatives, and protection against injection.
- How to Fetch and Respond to Reviews via APIFetch reviews from Google, Facebook and custom review sites, filter them, post owner replies, add internal notes and read review analytics with the Synup API.
- How to Build Automated Review-Response WorkflowsBuild a review-response workflow that routes reviews by rating and sentiment, drafts replies, approves them, and pushes them back to the platform.
- Respond to a Review via APIPost an owner reply to a review with the Synup API, read the push status back, and know which failures are worth a retry.