Synupv1
Crear clave
v1Recursos/Posts/patchActualizar una publicación

Actualizar una publicación

Actualiza una publicación editable (draft, scheduled, error o active) y reconcilia sus envíos por plataforma para que coincidan. Si la publicación no está programada ni guardada como borrador, esto puede publicar o cambiar lo que ya está activo en sus plataformas.

patch/api/v1/posts/{id}
posts:write
Parámetros de consulta
idstringobligatorio
La publicación a actualizar.
Cuerpo de la solicitud
locationIdstringopcional
La ubicación a la que se publica. Indique esta o clientId.
clientIdstringopcional
El cliente al que se publica a nivel de marca. Indique este o locationId.
namestringopcional
Nombre o etiqueta interna de la publicación. Obligatorio, no vacío.
postTypestring (announcement | event | offer)opcional
Tipo de publicación. event y offer son exclusivos de Google.
platformsarray of string (google | facebook | instagram | x | linkedin | pinterest | mastodon | bluesky | threads | tiktok)opcional
Plataformas de destino. Se requiere al menos una.
connectionIdsarray of stringopcional
IDs de conexión explícitos por los que publicar, en lugar de resolver plataformas a conexiones.
messageGooglestringopcional
Texto para Google. Obligatorio cuando se selecciona google, salvo que sea draft.
messageFacebookstringopcional
Texto social compartido para cada plataforma seleccionada que no sea Google. Obligatorio salvo que sea draft.
ctaTypestring (learn_more | sign_up | order_online | book | buy | call_now)opcional
Tipo de llamada a la acción.
ctaUrlstringopcional
URL de destino de la llamada a la acción.
mediaUrlsarray of objectopcional
Medios a adjuntar, una entrada por adjunto de plataforma.
urlstringopcional
platformstringopcional
typestring (image | video)opcional
eventTitlestringopcional
Título del evento u oferta. Obligatorio para un evento/oferta de Google, salvo que sea draft.
eventStartAtstringopcional
Hora de inicio del evento u oferta, como marca de tiempo ISO 8601. Obligatorio para un evento/oferta de Google, salvo que sea draft.
eventEndAtstringopcional
Hora de fin del evento u oferta, como marca de tiempo ISO 8601. Debe ser posterior al inicio.
offerTermsstringopcional
Términos de la oferta.
offerCouponCodestringopcional
Código de cupón de la oferta.
offerRedeemUrlstringopcional
URL de canje de la oferta.
scheduledForstringopcional
Publicar en esta marca de tiempo ISO 8601 futura en lugar de inmediatamente.
draftbooleanopcional
Guardar sin publicar. Omite las validaciones de campos obligatorios; las validaciones estructurales (límites, reglas de medios) siguen aplicándose.
Respuesta
dataobjectopcional
Una plataforma solicitada sin conexión activa, o un campo obligatorio que la publicación necesita antes de poder publicarse, nunca hace fallar esta llamada — la publicación se guarda de todos modos. Cuando existe alguna de estas dos brechas, status es "no_connection" o "incomplete" y la publicación viaja debajo como post.{id,status}; en una publicación limpia, el id/status de nivel superior describen la publicación directamente.
idstringopcional
Identificador único de la publicación.
statusstringopcional
Estado del ciclo de vida de la publicación: draft, scheduled, active o error.
missingFieldsarray of stringopcional
Campos aún necesarios antes de que esta publicación pueda activarse, si los hay.
missingPlatformsarray of stringopcional
Plataformas solicitadas sin conexión activa, si las hay.
scopestring (location | client)opcional
Si la brecha de conexión/campo aplica a nivel de ubicación o de cliente.
postobjectopcional
La publicación que se creó o actualizó.
idstringopcional
Identificador único de la publicación.
statusstringopcional
Estado del ciclo de vida de la publicación: draft, scheduled, active o error.
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.
patch/api/v1/posts/{id}
Su clave de API
id *
Cuerpo de la solicitud
{
  "data": {
    "id": "cm_post_abc123",
    "name": "Fall Special Announcement (updated)",
    "type": "announcement",
    "status": "scheduled",
    "postType": "announcement",
    "clientId": "cm_client_1",
    "locationId": "cm_loc_1",
    "platforms": [
      "google",
      "facebook"
    ],
    "messageGoogle": "Join us this weekend — now 25% off all services!",
    "messageFacebook": "Join us this weekend — now 25% off all services!",
    "ctaType": "learn_more",
    "ctaUrl": "https://acmedental.example.com/fall-special",
    "ctaUrlFacebook": null,
    "xThread": false,
    "ctaJson": {
      "ctaType": "learn_more",
      "ctaUrl": "https://acmedental.example.com/fall-special",
      "ctaUrlFacebook": null,
      "xThread": false
    },
    "mediaUrls": [
      {
        "url": "https://cdn.synup.com/uploads/a1/promo.jpg",
        "platform": "facebook",
        "type": "image"
      }
    ],
    "eventTitle": null,
    "eventStartAt": null,
    "eventEndAt": null,
    "offerTerms": null,
    "offerCouponCode": null,
    "offerRedeemUrl": null,
    "scheduledFor": "2026-02-10T15:00:00.000Z",
    "createdAt": "2026-01-20T09:12:00.000Z",
    "performance": []
  }
}