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

Crear una publicación

Crea una publicación para una ubicación o cliente y la envía a las plataformas seleccionadas. Esto publica contenido real: a menos que se indique scheduledFor o draft sea true, la publicación se activa de inmediato en sus plataformas de destino. Una plataforma solicitada sin conexión activa, o una publicación a la que le falte un campo obligatorio para publicarse, nunca hace fallar la llamada — el contenido se guarda como borrador en su lugar; consulte el esquema de la respuesta para ver cómo se informa esto.

post/api/v1/posts
posts:write
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.
namestringobligatorio
Nombre o etiqueta interna de la publicación. Obligatorio, no vacío.
postTypestring (announcement | event | offer)obligatorio
Tipo de publicación. event y offer son exclusivos de Google.
platformsarray of string (google | facebook | instagram | x | linkedin | pinterest | mastodon | bluesky | threads | tiktok)obligatorio
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.
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/posts
Su clave de API
Cuerpo de la solicitud*
{
  "data": {
    "id": "cm_post_abc123",
    "status": "scheduled"
  }
}