API de programaciónAPI

Programa una publicación con un solo campo

Envía el mismo cuerpo que usarías para publicar ahora, añade una marca de tiempo schedule_at y FoPost la guarda en la cola hasta ese momento. Todo se puede editar hasta el instante de salir, y la entrega se notifica por cuenta.

Consigue tu clave de APILee la documentación
POST /v1/posts
curl -X POST https://api.fopost.com/v1/posts \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "9b2f6c1e-...",
    "status": "scheduled",
    "schedule_at": "2026-09-01T09:00:00Z",
    "content": [{ "text": "Webhook retries are live. Read the changelog." }],
    "accounts": ["4a71d80b-...", "c30e9f12-..."]
  }'

Una marca de tiempo

Cualquier hora futura en ISO 8601. La cola la recoge y publica según lo programado.

Editable hasta el envío

Haz PUT del texto, los medios, las cuentas o la hora de cualquier elemento que siga en la cola.

Entrega por cuenta

Cuando sale, cada cuenta informa de su propio estado y enlace permanente.

Cola de publicación

Planifica una semana de publicaciones en un solo script

Recorre tu contenido, elige una hora para cada elemento y crea las publicaciones. La cola funciona en FoPost, así que tu propio proceso puede terminar en cuanto la petición responde. Lista las publicaciones programadas cuando quieras para ver qué viene.

Lee la referencia de publicaciones
GET /v1/posts?status=scheduled
curl "https://api.fopost.com/v1/posts?workspace_id=9b2f6c1e-...&status=scheduled" \
  -H "X-API-Key: $API_KEY"

{
  "data": [
    { "id": "7d3e0a52-...", "status": "scheduled", "schedule_at": "2026-09-01T09:00:00Z", "accounts": [{ "id": "4a71d80b-...", "platform": "linkedin", "publish_status": "pending" }] },
    { "id": "8e4f1b63-...", "status": "scheduled", "schedule_at": "2026-09-02T09:00:00Z", "accounts": [{ "id": "c30e9f12-...", "platform": "twitter", "publish_status": "pending" }] }
  ],
  "meta": { "page": 1, "per_page": 30, "total": 2, "total_pages": 1 }
}

Filtra por estado

Lista borradores, publicaciones programadas, publicadas o fallidas con un solo parámetro de consulta.

Etiquetas

Etiqueta cada publicación por campaña y filtra la cola por etiqueta.

Por espacio de trabajo

Una clave ve un solo espacio de trabajo, así que la cola de un cliente nunca se mezcla con la de otro.

Ajusta

Mueve, reescribe o cancela antes de que salga

Los planes cambian. Haz PUT de una publicación programada para cambiar su hora, texto, medios o cuentas de destino. Cancélala y quedará marcada como cancelada y nunca se entregará, o elimínala directamente. Nada queda bloqueado hasta que la cola la recoge.

Ver el endpoint PUT
PUT /v1/posts/:id
curl -X PUT https://api.fopost.com/v1/posts/7d3e0a52-... \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "schedule_at": "2026-09-01T14:00:00Z" }'

Reprograma

Cambia schedule_at y la cola moverá la publicación a la nueva hora.

Cambia el contenido

Reemplaza el array de contenido o los ids de medios de una publicación en cola.

Cancela o elimina

Saca una publicación de la cola sin tocar nada más.

Confirma

Sabe cuándo llegó, sin tener que consultar

Cuando llega la hora programada, la publicación se divide en una entrega por cuenta. Registra un webhook y se activará delivery.published o delivery.failed para cada una, o consulta el endpoint de entregas si prefieres un modelo de consulta.

Empieza a construir
Un mes de publicaciones programadas en el calendario de publicación

Webhook al resolverse

delivery.published incluye el id de la publicación, la cuenta y el enlace permanente.

Reintentos

Los errores de red temporales se reintentan con espera progresiva antes de informar de un fallo.

Analíticas después

Una vez publicada, el mismo id de publicación devuelve impresiones e interacción desde la API de analíticas.

Preguntas sobre API de programación, respondidas

¿Con cuánta antelación puedo programar?

Con toda la que quieras. Se acepta cualquier marca de tiempo ISO 8601 futura, y la cola guarda la publicación hasta entonces.

¿Qué zona horaria usa schedule_at?

Envía una marca de tiempo ISO 8601 en UTC, terminada en Z. El valor que envías es el que se ejecuta; el servidor no hace ninguna conversión.

¿Puedo editar una publicación después de programarla?

Sí. Haz PUT de cualquier campo, incluida la hora, en una publicación que aún no haya salido. Una vez publicada, los cambios se aplican al registro, y para quitarla de una red debes usar delete.

¿Qué pasa si mi servidor está caído a la hora de publicar?

Nada cambia. La cola funciona dentro de FoPost, no en tu infraestructura, así que la publicación sale tanto si tu proceso está en marcha como si no.

¿Puedo programar solo en algunas cuentas?

Sí. El array accounts es la lista de destino. Incluye solo las cuentas que deban recibir la publicación, y cada una tendrá su propio registro de entrega.

¿Hay un límite de frecuencia?

Sí, 100 peticiones por minuto por clave. Programar una semana de publicaciones en un solo script cabe de sobra.

Empieza hoy a construir con la API de programación

Empezar es gratis y la API completa está incluida. Crea una clave y haz tu primera llamada en minutos.

Consigue tu clave de API