v1Recursos/Reviews/postEnviar respuestas para que el cliente las apruebe
Enviar respuestas para que el cliente las apruebe
Pide a usuarios del portal del cliente que aprueben borradores de respuesta, una solicitud por reseña. Cada elemento lleva un reviewId y el texto de la respuesta; si omites text, se usa el borrador guardado de la reseña. El texto también se guarda como borrador de la reseña. Cada persona en clientUserIds debe ser un usuario activo del portal del cliente de la reseña y poder ver su ubicación. Primero se ejecutan las verificaciones de contenido, y una respuesta que señalen no se envía. Si la reseña ya tiene una solicitud abierta, se actualiza: un texto nuevo es una versión nueva sobre la que se vuelve a preguntar al cliente, y las personas nuevas se añaden. Cada reseña tiene éxito o falla por separado, así que la llamada devuelve 201 aunque fallen algunos elementos; revisa ok y code en cada resultado. Los usuarios del cliente reciben un correo electrónico y una notificación en la app, y las solicitudes enviadas en poco tiempo llegan a cada persona como un solo mensaje. Si el correo no se puede enviar, la solicitud sigue esperando en su portal.
post
reviews:write/api/v1/reviews/reply-approvalsCuerpo de la solicitud
itemsarray of objectobligatorio
Las reseñas que se envían, de 1 a 200. Cada reseña recibe su propia solicitud.
reviewIdstringobligatorio
La reseña a la que contesta la respuesta.
textstringopcional
La respuesta que se debe aprobar, hasta 4096 caracteres. Omítela para usar el borrador guardado de la reseña.
clientUserIdsarray of stringobligatorio
Los usuarios del portal del cliente a los que se pregunta, de 1 a 50, de la lista de usuarios del portal del cliente. Cada uno debe poder ver la ubicación de la reseña; si no, esa reseña falla con ineligible_assignee.
notestringopcional
Un mensaje opcional para los usuarios del cliente, hasta 2000 caracteres.
Respuesta
dataobjectopcional
resultsarray of objectopcional
Un resultado por elemento. Las reseñas no encontradas, o que pertenecen a un cliente al que el token no tiene acceso, aparecen al final.
reviewIdstringopcional
La reseña a la que corresponde este resultado.
okbooleanopcional
true si la solicitud se creó o se actualizó.
requestIdstringopcional
El ID de la solicitud, cuando ok es true.
errorstringopcional
Por qué no se envió esta reseña, cuando ok es false.
codestring (not_found | not_respondable | no_draft | ineligible_assignee | content_checks)opcional
Por qué falló: not_found (no existe la reseña, o pertenece a un cliente al que el token no tiene acceso), not_respondable (no se puede responder a la reseña en Synup, o ya tiene una respuesta publicada), no_draft (no se envió text y la reseña no tiene borrador guardado), ineligible_assignee (alguien en clientUserIds no puede ver la ubicación de la reseña) o content_checks (las verificaciones de contenido señalaron la respuesta; corrígela y vuelve a enviarla).
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.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
post/api/v1/reviews/reply-approvals
Su clave de API
Cuerpo de la solicitud*
{}Guías que usan este recurso
- Google Business Profile API vs a Listings Management APIHow Google's Business Profile API compares with a listings management API on scope, access, sync status, duplicates and reviews, and when to use each.
- 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 Build a Multi-Location Marketing DashboardBuild a multi-location marketing dashboard from the API's rollup endpoints, one call per panel, covering listings, reviews, rank, AI visibility and duplicates.
- How to Add Local Marketing Functionality to Vertical SaaSAdd local marketing to a vertical SaaS by mapping existing customers to clients and locations, and shipping only the features your niche needs.
- 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.
- Fetch Recent Reviews via APIPull a location's reviews from every connected platform with the Synup API, filter to what needs attention, and page through with a cursor.
- Local SEO APIs: What Developers Actually NeedA practical checklist of what a local SEO API must cover, from listings and sync status to reviews, rank tracking and AI visibility, mapped to endpoints.
- How to Retrieve Google Business Profile Analytics via APIPull Google Business Profile analytics through an API, portfolio-wide and per location, with views, calls, direction requests and a maps-versus-search split.
- 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.