API de publicaciónAPI

Un POST para publicar en todas partes

Crea una publicación una vez, indica las cuentas a las que debe llegar y FoPost se ocupa del formato, la subida de medios y la entrega en cada red. Claves con permisos, peticiones idempotentes y un estado de entrega que puedes consultar o recibir por webhook.

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-...",
    "content": [{ "text": "Shipped a new release today." }],
    "accounts": ["4a71d80b-...", "c30e9f12-..."]
  }'

curl -X POST https://api.fopost.com/v1/posts/7d3e0a52-.../publish \
  -H "X-API-Key: $API_KEY"

Todas las redes, un mismo formato

El mismo cuerpo de petición publica en X, LinkedIn, Instagram y cualquier otra cuenta conectada.

Claves con permisos

Una clave con el permiso publish puede publicar y nada más. Revócala sin tocar las demás.

Entrega por cuenta

Cada cuenta informa de su propio estado, id externo y enlace permanente cuando ya está publicada.

Publica

Escribe la publicación una vez y elige cualquier conjunto de cuentas

Indica el texto, los medios y las cuentas de destino. FoPost aplica los límites y las convenciones de cada red, sube los medios en el formato que pide la plataforma y devuelve un id de publicación que puedes seguir. Hilos, carruseles y textos largos usan el mismo array de contenido.

Lee la referencia de publicación
Respuesta
{
  "post_status": "publishing",
  "deliveries": [
    { "id": "a3c5e7f9-...", "account_id": "4a71d80b-...", "status": "queued", "external_url": null, "posted_at": null, "attempts": 0 },
    { "id": "b4d6f8a0-...", "account_id": "c30e9f12-...", "status": "queued", "external_url": null, "posted_at": null, "attempts": 0 }
  ],
  "health_warnings": []
}

Bloques de contenido

Los bloques ordenados se convierten en un hilo, un carrusel o un cuerpo de texto según la red.

Medios por referencia

Sube una vez a la biblioteca de medios y adjunta por id a tantas publicaciones como quieras.

Idempotente

Envía una clave de idempotencia y una petición reintentada nunca publicará dos veces.

Haz seguimiento

Sabe exactamente dónde llegó cada publicación

Una publicación se divide en una entrega por cuenta. Consulta el endpoint de entregas o suscríbete a un webhook y recibirás el estado en la plataforma, el id externo, el enlace permanente y el texto del error cuando una red rechace algo.

Ver eventos de webhook
Cuentas conectadas de todas las redes en un solo espacio de trabajo

Endpoint de entregas

GET /v1/posts/:id/deliveries lista cada cuenta con su propio estado.

Eventos de webhook

delivery.published y delivery.failed se activan en cuanto una entrega se resuelve.

Reintentos incluidos

Los errores temporales de la plataforma se reintentan con espera progresiva antes de marcarse como fallidos.

Gestiona

Edita, cancela y elimina desde el código

Todo el ciclo de vida está en la API. Actualiza una publicación programada antes de que salga, cancélala o elimina una publicación ya publicada de la red donde apareció. Las etiquetas y los espacios de trabajo mantienen separado el trabajo de cada cliente cuando gestionas más de una marca.

Empieza a construir
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 '{ "content": [{ "text": "Updated copy." }] }'

Edita antes de publicar

Cambia el texto, los medios o las cuentas de cualquier elemento que siga en la cola.

Etiquetas

Etiqueta las publicaciones por campaña o cliente y filtra por etiqueta cualquier endpoint de listado.

Espacios de trabajo

Las claves son por espacio de trabajo, así que un cliente nunca puede acceder a otro.

Preguntas sobre API de publicación, respondidas

¿Cómo me autentico?

Crea una clave de API en el panel, en Ajustes, y envíala en una cabecera X-API-Key. Cada clave pertenece a un espacio de trabajo y solo tiene los permisos que le concedas.

¿En qué redes puedo publicar?

En todas las cuentas conectadas al espacio de trabajo, en cada red que admite FoPost. El formato de la petición es el mismo para todas.

¿Puedo adjuntar imágenes y vídeo?

Sí. Sube el archivo una vez con la API de medios y luego haz referencia al id del medio en la publicación. Los límites de tamaño y formato de cada red se aplican automáticamente.

¿Qué pasa si una red está caída?

La entrega se reintenta con espera progresiva. Si sigue fallando, se marca como fallida con el error de la plataforma y se activa un webhook delivery.failed.

¿Hay un límite de frecuencia?

Sí, 100 peticiones por minuto por clave. El límite y las peticiones restantes se devuelven en las cabeceras de respuesta.

¿Hay un SDK?

Un SDK tipado de TypeScript, un servidor MCP para clientes de IA y paquetes gratuitos de PHP, Laravel y WordPress. La especificación OpenAPI se sirve desde la API para cualquier otro lenguaje.

Empieza hoy a construir con la API de publicació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