v1Recursos/Reviews/postResponder a una reseña
Responder a una reseña
Publica la respuesta del propietario a una reseña o la reemplaza: una reseña tiene una sola respuesta, así que una segunda llamada edita la primera (Google la actualiza; en Facebook se edita nuestro comentario de respuesta). pushed: false significa que la respuesta aún no está publicada: o la plataforma la aceptó y todavía la está publicando (status pending), o la plataforma no tiene API de respuestas y solo se guardó en Synup. Falla con 422 si no se puede responder a la reseña o la plataforma la rechazó; retryable indica si volver a intentarlo puede funcionar.
post
reviews:write/api/v1/reviews/replyCuerpo de la solicitud
reviewIdstringobligatorio
La reseña a la que responder. Obligatorio.
textstringobligatorio
El texto de la respuesta a publicar. Obligatorio.
Respuesta
dataobjectopcional
okbooleanopcional
Si la respuesta fue aceptada.
pushedbooleanopcional
Si la respuesta está publicada en la plataforma de origen. False mientras la plataforma todavía la publica (status pending), o cuando la plataforma no tiene API de respuestas y la respuesta solo se guarda en Synup.
statusstring (posted | pending | failed | draft)opcional
Uno de: posted, pending, failed, draft.
externalReplyIdstringopcional
El id de la respuesta en la plataforma de origen, o null.
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
404El recurso no se encontró, o no pertenece a su agencia.
422A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
post/api/v1/reviews/reply
Su clave de API
Cuerpo de la solicitud*
{
"data": {
"ok": true,
"pushed": true,
"status": "posted",
"externalReplyId": "ext_reply_123",
"retryable": null
}
}Guías que usan este 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.