v1Ressources/Reviews/postEnvoyer des réponses à la validation du client
Envoyer des réponses à la validation du client
Demande à des utilisateurs du portail client d’approuver des brouillons de réponse, une demande par avis. Chaque élément contient un reviewId et le texte de la réponse ; sans text, le brouillon enregistré de l’avis est utilisé. Le texte est aussi enregistré comme brouillon de l’avis. Chaque personne de clientUserIds doit être un utilisateur actif du portail du client de l’avis et pouvoir voir l’établissement de l’avis. Les vérifications de contenu passent d’abord, et une réponse qu’elles signalent n’est pas envoyée. Si l’avis a déjà une demande ouverte, elle est mise à jour : un nouveau texte devient une nouvelle version soumise à nouveau au client, et les nouvelles personnes y sont ajoutées. Chaque avis réussit ou échoue séparément, donc l’appel renvoie 201 même si certains éléments échouent ; vérifiez ok et code dans chaque résultat. Les utilisateurs clients reçoivent un e-mail et une notification dans l’application, et les demandes envoyées à peu d’intervalle arrivent à chaque personne en un seul message. Si l’e-mail ne peut pas être envoyé, la demande reste en attente dans leur portail.
post
reviews:write/api/v1/reviews/reply-approvalsCorps de la requête
itemsarray of objectobligatoire
Les avis à envoyer, de 1 à 200. Chaque avis reçoit sa propre demande.
reviewIdstringobligatoire
L’avis auquel la réponse répond.
textstringfacultatif
La réponse à approuver, 4096 caractères au maximum. Omettez-la pour utiliser le brouillon enregistré de l’avis.
clientUserIdsarray of stringobligatoire
Les utilisateurs du portail client à solliciter, de 1 à 50, issus de la liste des utilisateurs du portail du client. Chacun doit pouvoir voir l’établissement de l’avis, sinon cet avis échoue avec ineligible_assignee.
notestringfacultatif
Un message facultatif pour les utilisateurs clients, 2000 caractères au maximum.
Réponse
dataobjectfacultatif
resultsarray of objectfacultatif
Un résultat par élément. Les avis introuvables, ou appartenant à un client auquel le jeton n’a pas accès, figurent à la fin.
reviewIdstringfacultatif
L’avis concerné par ce résultat.
okbooleanfacultatif
true si la demande a été créée ou mise à jour.
requestIdstringfacultatif
L’identifiant de la demande, quand ok vaut true.
errorstringfacultatif
Pourquoi cet avis n’a pas été envoyé, quand ok vaut false.
codestring (not_found | not_respondable | no_draft | ineligible_assignee | content_checks)facultatif
La raison de l’échec : not_found (avis inexistant, ou appartenant à un client auquel le jeton n’a pas accès), not_respondable (impossible de répondre à l’avis dans Synup, ou il a déjà une réponse publiée), no_draft (aucun text envoyé et aucun brouillon enregistré pour l’avis), ineligible_assignee (une personne de clientUserIds ne voit pas l’établissement de l’avis) ou content_checks (les vérifications de contenu ont signalé la réponse ; corrigez-la et renvoyez-la).
Erreurs
400Il manque un paramètre requis à la requête, ou elle est invalide.
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
post/api/v1/reviews/reply-approvals
Votre clé API
Corps de la requête*
{}Guides qui utilisent cette ressource
- 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.