Crear post recurrente
Crea una serie de publicaciones recurrentes.
Crea una serie de publicaciones recurrentes.
/api/v1/recurring-postCrea un post recurrente y programa su primera ejecución.
{
"accountId": "<accountId>",
"text": "Una actualización semanal útil de dopost",
"startsAt": "2026-09-25T10:00:00Z",
"timezone": "Europe/Madrid",
"recurrence": {
"frequency": "WEEKLY",
"interval": 1,
"weekdays": [5],
"endType": "AFTER_OCCURRENCES",
"occurrenceCount": 8
}
}{
"accountId": "<accountId>",
"text": "Una actualización semanal útil de dopost",
"startsAt": "2026-09-25T10:00:00Z",
"timezone": "Europe/Madrid",
"recurrence": {
"frequency": "WEEKLY",
"interval": 1,
"weekdays": [5],
"endType": "AFTER_OCCURRENCES",
"occurrenceCount": 8
}
}| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
accountId | string | Sí | ID de la cuenta social conectada. |
text | string | Condicional | Texto del post. Obligatorio si media está vacío. |
media | string[] | object[] | Condicional | Hasta 10 elementos multimedia públicos. |
startsAt | string | Sí | Primera ejecución en ISO 8601, al menos dos minutos en el futuro. |
timezone | string | No | Zona horaria IANA. Por defecto usa la del workspace. |
recurrence | object | Sí | Reglas de recurrencia descritas abajo. |
platformOptions | object | No | Las mismas opciones que acepta Publicar post. |
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
frequency | DAILY | WEEKLY | MONTHLY | Sí | Frecuencia. |
interval | integer | No | Repite cada N días, semanas o meses, entre 1 y 365. |
weekdays | integer[] | Semanal | Días del 0 (domingo) al 6 (sábado). |
endType | NEVER | ON_DATE | AFTER_OCCURRENCES | No | Por defecto NEVER. |
endDate | string | Con ON_DATE | Fecha final ISO 8601. |
occurrenceCount | integer | Con AFTER_OCCURRENCES | Total de ejecuciones, entre 2 y 500. |
Los adjuntos se copian al almacenamiento de dopost y se comprueban con las mismas reglas de publicación que el compositor web antes de crear la serie. Los errores bloqueantes rechazan la petición; las advertencias permiten continuar. Consulta Errores de validación detallados para conocer la respuesta y los detalles del archivo.
{
"success": true,
"recurringPostId": "cm_recurring_123",
"postId": "cm_post_123",
"nextRunAt": "2026-09-25T10:00:00.000Z",
"status": "ACTIVE"
}{
"success": true,
"recurringPostId": "cm_recurring_123",
"postId": "cm_post_123",
"nextRunAt": "2026-09-25T10:00:00.000Z",
"status": "ACTIVE"
}El primer post se programa para startsAt; los siguientes siguen la recurrencia configurada.
Usa create_recurring_post. La tool expone los campos de recurrencia en el primer nivel para facilitar su uso por un agente.
Las fechas y horas sin zona (2027-01-20T10:00:00) se interpretan en la zona horaria IANA del workspace. No hace falta indicarla. Las fechas con Z u offset explícito conservan su instante; dopost hace la conversión y guarda UTC. Una hora local inexistente por cambio de horario se rechaza. Para distinguir dos horas repetidas, incluye un offset explícito.
En publicación y reprogramación puedes enviar timezone como override IANA opcional, por ejemplo Europe/Madrid. En recurrentes, timezone selecciona la zona de la serie y de la fecha inicial; por defecto es la del workspace. Al actualizar una serie se conserva su zona actual. recurrence.endDate representa la fecha de calendario de fin de la serie.
Google Business: solo postType: "standard"; se aplican las mismas validaciones de texto, CTA e imagen que al publicar. Los eventos, ofertas y publicaciones de galería no son recurrentes en dopost.