Synupv1
Crear clave
v1Recursos/Post Ideas/postCrear una idea de publicación

Crear una idea de publicación

Crea (o, para un externalId repetido, actualiza) una idea de publicación en borrador, pendiente de revisión o lista para publicarse.

post/api/v1/post-ideas
ideas:write
Cuerpo de la solicitud
locationIdstringopcional
La ubicación para la que es esta idea, u omítalo para una idea a nivel de marca.
clientIdstringopcional
El cliente para el que es esta idea (ideas a nivel de marca).
titlestringobligatorio
El título de la idea. Obligatorio al crear.
contentstringopcional
El texto/contenido de la idea.
externalIdstringobligatorio
Un ID estable que usted controla — reintentar una creación con el mismo externalId actualiza la idea existente en lugar de duplicarla. Obligatorio al crear.
originstring (channel | routine | os_button)obligatorio
De dónde proviene esta idea: channel, routine u os_button. Obligatorio al crear.
typestring (announcement | offer | tip | showcase | story | event)opcional
Tipo de idea.
bucketstring (idea | holiday | calendar | series)opcional
En qué bucket de la cuadrícula se ubica la idea.
platformsarray of stringopcional
Plataformas para las que está pensada esta idea.
imageUrlstringopcional
URL de una imagen para adjuntar a la idea.
imagePromptstringopcional
El prompt usado para generar la imagen de la idea.
seriesIdstringopcional
ID de la serie de contenido a la que adjuntar esta idea.
scheduledDatestringopcional
Fecha de publicación planificada (YYYY-MM-DD).
scheduledTimestringopcional
Hora de publicación planificada.
generationJobIdstringopcional
ID del trabajo de generación de IA que produjo esta idea, si lo hay.
Respuesta
dataobjectopcional
idstringopcional
Identificador único de la idea de publicación.
createdbooleanopcional
Si esta llamada creó una idea nueva (false si ya existía una idea con este externalId y se actualizó en su lugar).
reviewStatusstringopcional
Puerta de aprobación: null (sin puerta), pending, approved o rejected.
statusstringopcional
Estado de la idea: draft, published o archived.
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/post-ideas
Su clave de API
Cuerpo de la solicitud*
{
  "data": {
    "id": "cm_idea_abc123",
    "created": true,
    "reviewStatus": null,
    "status": "draft"
  }
}