Synup
Crear clave
v1Recursos/Reviews/postCrear un widget de reseñas

Crear un widget de reseñas

Crea un nuevo widget de reseñas incrustable (insignia de calificación + carrusel/lista de reseñas) para una ubicación.

post/api/v1/reviews/widgets
reviews:write
Cuerpo de la solicitud
locationIdstringobligatorio
clientIdstringobligatorio
namestringopcional
minRatingintegeropcional
sourcesarray of stringopcional
selectionModestringopcional
dateWindowstring (30d | 90d | 1y | all)opcional
countintegeropcional
includeInternalbooleanopcional
layoutstringopcional
statusstring (draft | published)opcional
Respuesta
dataobjectopcional
widgetobjectopcional
idstringopcional
agencyIdstringopcional
locationIdstringopcional
clientLocationIdstringopcional
namestringopcional
minRatingintegeropcional
sourcesarray of stringopcional
selectionModestringopcional
dateWindowstringopcional
manualReviewIdsarray of stringopcional
countintegeropcional
includeInternalbooleanopcional
emojiPositiveRatingintegeropcional
layoutstringopcional
marqueeSpeedintegeropcional
themeobjectopcional
themeOverridesobjectopcional
showFlagsobjectopcional
statusstring (draft | published)opcional
createdAtstringopcional
updatedAtstringopcional
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.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
post/api/v1/reviews/widgets
Su clave de API
Cuerpo de la solicitud*
{
  "data": {
    "widget": {
      "id": "cm_widget_1",
      "agencyId": "cm_agency_1",
      "locationId": "cm_loc_1",
      "clientLocationId": "cm_loc_1",
      "name": "Homepage reviews",
      "minRating": 4,
      "sources": [],
      "selectionMode": "recent",
      "dateWindow": "all",
      "manualReviewIds": [],
      "count": 10,
      "layout": "carousel",
      "theme": "brand",
      "themeOverrides": null,
      "showFlags": null,
      "status": "published",
      "includeInternal": false,
      "emojiPositiveRating": 4,
      "marqueeSpeed": 5,
      "createdAt": "2026-01-15T09:00:00.000Z",
      "updatedAt": "2026-01-15T09:00:00.000Z",
      "createdByUserId": "cm_user_1",
      "createdByType": "user"
    }
  }
}

Guías que usan este endpoint