
Guías de integración
Guía de la API de LinkedIn
Guía de la API de email
Guía de la API de WhatsApp
Contactar con ventas
Publicar, editar, eliminar y leer publicaciones de Facebook por API en 2026, con la Pages API de Meta o con las cuentas conectadas de sus propios usuarios.
posts
PATCHposts/{id}
DELETEposts/{id}
200 OK
Una API de publicaciones de Facebook permite a su app publicar, editar, eliminar y leer publicaciones de Facebook mediante peticiones HTTP. Hay dos vías: la Pages API de Meta, que solo publica en Páginas de Facebook a través de una app de Meta y de Page access tokens, o una cuenta conectada, en la que cada usuario vincula su propia cuenta de Facebook y su app publica como su perfil o como una Página que gestiona.
Para una visión más amplia de la plataforma de Meta, consulte cómo encajan las API de Facebook.
Publique en Facebook en tres pasos
Conectar la cuentaSu usuario vincula su cuenta de Facebook, y las Páginas que gestiona, mediante Hosted Auth. Sin app de Meta ni App Review.
Crear la publicaciónEnvíe POST /v2/{account_id}/posts con su clave en X-API-KEY y un texto o archivos adjuntos.
Editar, eliminar o publicar como PáginaLlame a PATCH o DELETE sobre la publicación, o añada post_as con el ID de una Página activada.
Meta no tiene ningún producto llamado "Post API". Las publicaciones de Facebook son objetos de la Graph API, y las apps las publican a través de la Pages API, que solo escribe en Páginas de Facebook. Desde 2018, una app de terceros ya no puede publicar en el perfil propio de una persona.
En la práctica, "API de publicaciones de Facebook", o lo que los desarrolladores llaman la API de Facebook para publicar, designa las llamadas a la Graph API sobre un nodo de publicación y sobre el edge /feed de una Página. Nodos, edges y tokens: consulte nuestra presentación de la Graph API de Facebook.
{page_id}_{post_id}El nodo de la publicación. Su ID une el ID del autor y el de la publicación./{page_id}/feedEl edge que lista las publicaciones de una Página y recibe las nuevas.messageEl texto de la publicación.created_timeCuándo se publicó./{page_id}/photosEl edge de las publicaciones con fotos.Envíe POST /{page_id}/feed con un message (y, opcionalmente, un link), usando un Page access token (consulte la guía de la API de Páginas de Facebook y nuestra guía sobre el token de acceso de la API de Facebook). Meta devuelve el ID de la nueva publicación en la forma {"id": "{page_post_id}"}.
Cree una app y añada Facebook Login for Business.
pages_show_listSolicite los derechos de publicación y supere el App Review.
pages_manage_postsObtenga el token de Página a partir del user token.
GET /me/accountsPublique en el feed de la Página con el token de Página.
POST /{page_id}/feedpages_manage_posts, pages_read_engagement y pages_show_list, por parte de alguien que pueda realizar la tarea CREATE_CONTENT en la Página.pages_manage_engagement y pages_read_user_engagement, con las tareas CREATE_CONTENT, MANAGE y MODERATE.publish_video.La petición y su respuesta están en las pestañas Meta cURL y Meta Python del bloque de código de abajo, junto a la versión de Unipile.
| Parámetro | Qué hace |
|---|---|
message | El texto de la publicación |
link | Una URL mostrada con vista previa del enlace |
published | false para una publicación no publicada o programada |
scheduled_publish_time | Fecha de publicación, entre 10 minutos y 30 días después |
false para una publicación no publicada o programadaFotos y vídeo. Una sola foto va a /{page_id}/photos. Para una publicación con varias fotos, suba cada foto a ese edge con published=false y publíquelas juntas en /{page_id}/feed con attached_media y los ID devueltos; las fotos no publicadas se eliminan pasadas 24 horas. Los vídeos pasan por la Video API con publish_video.
Fuente: de Meta, documentación de publicaciones de la Pages API, Pages API getting started, la referencia del feed de Página y la referencia de las fotos de Página (Graph API v27.0). Última verificación: 17 de noviembre de 2026.
Tres reglas de la Graph API condicionan cualquier proyecto de publicación en Facebook: las apps no pueden publicar en perfiles personales ni en Grupos, y solo pueden modificar las publicaciones de Página que ellas mismas crearon.
Meta retiró a las apps el permiso publish_actions el 1 de agosto de 2018. Detalles en los límites de la API oficial de Facebook.
La Groups API y publish_to_groups quedaron obsoletos con la Graph API v19.0 el 23 de enero de 2024.
"Una app solo puede actualizar una publicación de Página si la publicación se hizo con esa app."
Su app no puede modificar una publicación escrita en facebook.com o con otra herramienta, así que un producto que edita publicaciones debe crearlas.
Los primeros errores que encontrará. Con la Graph API, el código 190 significa que el access token ha caducado, los códigos 200 a 299 indican que un permiso no se concedió o se retiró, y 4 o 17 indican demasiadas llamadas. Con Unipile, publicar como una Página que no está activada devuelve 403 api/insufficient_permissions.
Fuentes: de Meta, documentación de publicaciones de la Pages API, changelog de Facebook Login, anuncio de la Graph API v19.0 y gestión de errores de la Graph API. Última verificación: 17 de noviembre de 2026.
Con Unipile, cada usuario conecta su cuenta de Facebook mediante Hosted Auth y su app obtiene un account_id. Se crea una publicación con POST /v2/{account_id}/posts, se modifica su texto con PATCH y se elimina con DELETE. Una publicación eliminada va a la papelera, donde su autor aún puede leerla durante 30 días.
Sin app de Meta ni App Review por su parte: cada llamada envía su API key en X-API-KEY y se ejecuta en nombre del usuario que conectó la cuenta. Las pestañas Meta muestran la misma publicación con la Graph API y un Page access token, para comparar.
const BASE = "https://api.unipile.com/v2";
const headers = {
"X-API-KEY": process.env.UNIPILE_API_KEY,
"content-type": "application/json"
};
// 1. Publish a text post from the connected account
await fetch(`${BASE}/${ACCOUNT_ID}/posts`, {
method: "POST", headers,
body: JSON.stringify({ text: "Our autumn menu starts Monday." })
});
// 2. Edit its text later (media and audience are kept)
await fetch(`${BASE}/${ACCOUNT_ID}/posts/${POST_ID}`, {
method: "PATCH", headers,
body: JSON.stringify({ text: "Our autumn menu starts Monday at 7am." })
});
import os, requests
BASE = "https://api.unipile.com/v2"
headers = {"X-API-KEY": os.environ["UNIPILE_API_KEY"]}
# 1. Publish a text post from the connected account
requests.post(f"{BASE}/{ACCOUNT_ID}/posts", headers=headers,
json={"text": "Our autumn menu starts Monday."})
# 2. Edit its text later (media and audience are kept)
requests.patch(f"{BASE}/{ACCOUNT_ID}/posts/{POST_ID}", headers=headers,
json={"text": "Our autumn menu starts Monday at 7am."})
# 1. Publish a text post from the connected account
curl --request POST \
--url "https://api.unipile.com/v2/{ACCOUNT_ID}/posts" \
--header "X-API-KEY: {YOUR_API_KEY}" \
--header "content-type: application/json" \
--data '{ "text": "Our autumn menu starts Monday." }'
# 2. Edit its text later (media and audience are kept)
curl --request PATCH \
--url "https://api.unipile.com/v2/{ACCOUNT_ID}/posts/{POST_ID}" \
--header "X-API-KEY: {YOUR_API_KEY}" \
--header "content-type: application/json" \
--data '{ "text": "Our autumn menu starts Monday at 7am." }'
# Meta Graph API: publish to a Page with a Page access token
curl -X POST "https://graph.facebook.com/v27.0/{PAGE_ID}/feed" \
-H "Content-Type: application/json" \
-d '{
"message": "Our autumn menu starts Monday.",
"link": "https://example.com/menu",
"access_token": "{PAGE_ACCESS_TOKEN}"
}'
# Response: the ID of the new Page post
{ "id": "{PAGE_POST_ID}" }
# Read that post back with the fields you need
curl -G "https://graph.facebook.com/v27.0/{PAGE_POST_ID}" \
-d "fields=id,message,created_time,permalink_url" \
-d "access_token={PAGE_ACCESS_TOKEN}"
import os, requests
GRAPH = "https://graph.facebook.com/v27.0"
TOKEN = os.environ["PAGE_ACCESS_TOKEN"]
# Meta Graph API: publish to a Page
r = requests.post(f"{GRAPH}/{PAGE_ID}/feed", data={
"message": "Our autumn menu starts Monday.",
"link": "https://example.com/menu",
"access_token": TOKEN,
})
post_id = r.json()["id"] # {"id": "{PAGE_POST_ID}"}
# Read that post back with the fields you need
post = requests.get(f"{GRAPH}/{post_id}", params={
"fields": "id,message,created_time,permalink_url",
"access_token": TOKEN,
}).json()
Los campos de la petición están en Create posts; la edición y la papelera, en Edit and delete posts. Las pestañas Meta siguen la guía de publicaciones de la Pages API y la referencia Post, v27.0, verificadas el 17 de noviembre de 2026.
| Campo o caso | Regla |
|---|---|
text y attachments | Texto o adjunto obligatorio. Archivos en base64, o en multipart para los archivos grandes |
| Imágenes | Varias imágenes forman un álbum |
| Vídeo | Un vídeo por publicación, nunca mezclado con imágenes |
quoted_post_id | Comparte una publicación, sin adjuntos |
| Menciones | @ más un ID o un nombre de usuario en text |
can_read | anyone (por defecto) o relations_only |
can_comment | Solo anyone; si no, 400 |
@ más un ID o un nombre de usuario en textanyone (por defecto) o relations_onlyanyone; si no, 400Sus usuarios publican desde sus propias cuentas
Unipile no es un producto de Meta ni un Meta Partner. Sus usuarios conectan sus propias cuentas, deciden qué se publica y siguen sujetos a las condiciones de Meta.
Añada post_as con el ID de una Página que la cuenta administre y que esté activada en la cuenta. No hay que conectar ninguna cuenta aparte: el mismo account_id cubre el perfil del usuario y sus Páginas.
PAGE_<page_id>_INBOX.403 api/insufficient_permissions.Los pasos de configuración están en la documentación de Facebook Pages.
POST /v2/{account_id}/posts
{
"text": "Hello from our Page!",
"post_as": "1357020157484056"
}
Con la API de Meta, llame a GET /{page_id}/feed con un Page access token. Con Unipile, llame a GET /v2/, donde user_id es me, el ID de una Página activada o el ID de otra persona o Página cuyas publicaciones la cuenta conectada ya puede ver en Facebook.
Uso típico: la actividad reciente en un CRM o una herramienta social, para las cuentas que conectaron sus usuarios. Leer las publicaciones de otra persona no va más allá de lo que la cuenta conectada ya ve en Facebook, y solo ocurre cuando el usuario lo solicita.
¡Con muchas ganas de unirme al equipo de Lisboa el mes que viene!
Ya están disponibles las diapositivas de mi charla sobre herramientas de soporte.
Excursión de fin de semana con el equipo.
next_cursor: "QVFIUm..."v2/{ACCOUNT_ID}/users/{USER_ID}/posts
200 OK
/v2/{account_id}/users/{user_id}/posts me, el ID de una Página activada o el ID de otra persona o Página, limitado a las publicaciones que la cuenta conectada ya puede ver/v2/{account_id}/posts/{post_id} <author id>_<post id>account_idFacebook devuelve hasta 3 publicaciones por página, sea cual sea el limit que envíe. Siga next_cursor para obtener la página siguiente; no existe offset. Detalles en List user posts.
La Pages API de Meta encaja con una app que publica en las Páginas de su propia empresa, o en Páginas de clientes que pasan por su app de Meta. Una cuenta conectada encaja con un producto SaaS en el que cada usuario publica desde su propio perfil y sus Páginas, sin app de Meta por su parte.
| Criterio | Pages API de Meta | Cuenta conectada (Unipile) |
|---|---|---|
| Cuentas cubiertas | Las Páginas que gestionan los usuarios de su app | El perfil del usuario y las Páginas que gestiona |
| Configuración por su parte | App de Meta, Facebook Login, App Review | API key y Hosted Auth, sin App Review |
| Credenciales | Un token de Página por Página | Un account_id por usuario |
| Publicaciones en el perfil personal | No disponible desde 2018 | Sí, como el usuario conectado |
| Edición de publicaciones | Solo las publicaciones hechas con su app | Texto de una publicación, por post_id |
| Grupos | Obsoleta desde la v19.0 | No compatible |
| Stories | Fuera del alcance de esta guía | No compatible |
| Programación | scheduled_publish_time, de 10 minutos a 30 días | No documentada; use su propia cola de tareas |
| Otras redes | Solo Páginas de Facebook | La misma API para LinkedIn, Instagram, WhatsApp y más |
account_id por usuariopost_idscheduled_publish_time, de 10 minutos a 30 díasLa misma conexión cubre las conversaciones: consulte la API de Facebook y Messenger de Unipile, cómo conectar una cuenta personal de Facebook y los precios de la API de Facebook Messenger.
La API de publicaciones de Facebook rinde al máximo dentro de los productos en los que la gente ya trabaja, con cada usuario publicando desde sus propias cuentas.
Los community managers publican y corrigen publicaciones de su perfil y sus Páginas, junto a sus mensajes.
Cuando el comercial lo solicita, una ficha de contacto muestra las últimas publicaciones de la persona, limitadas a lo que la cuenta conectada del comercial ya ve en Facebook.
Un agente redacta una publicación, el usuario la aprueba y solo entonces su app envía el POST.
El mismo modelo de publicaciones funciona en otras redes: nuestra guía de la API de Instagram cubre la otra red de Meta.
Empiece a publicar en Facebook desde su app
Use la Pages API de Meta para sus propias Páginas. Cuando cada usuario publica, edita y lee publicaciones desde su propio perfil y sus Páginas, conecte sus cuentas a través de Unipile: una sola API REST.
Cada usuario conecta su propia cuenta, sin almacenamiento de perfiles. Unipile no es Meta Partner. Más información
Todos los endpoints de la API de Facebook en un solo lugar
Las publicaciones son solo una parte. Consulte todos los endpoints de Facebook disponibles con Unipile, de los mensajes a los perfiles, o lea la guía completa de la API de Facebook.
Respuestas rápidas sobre Páginas, fotos, programación, ediciones, Grupos, vídeo y lectura de publicaciones.
Con la Pages API de Meta, envíe POST /{page_id}/feed con un message, usando un Page access token y los permisos pages_manage_posts, pages_read_engagement y pages_show_list. Con Unipile, el usuario conecta su cuenta de Facebook una sola vez y usted llama a POST /v2/{account_id}/posts con post_as igual al ID de una Página que gestiona y ha activado.
Con Unipile, varias imágenes en una publicación se muestran como un álbum, y una publicación puede llevar en su lugar un vídeo, nunca ambos. Con la Pages API de Meta, las fotos se publican mediante el edge /{page_id}/photos.
La Pages API de Meta sí: cree la publicación con published en false y un scheduled_publish_time entre 10 minutos y 30 días después, según la guía de la Pages API (la referencia de Page feed indica 75 días; pruébelo en su versión). Unipile no documenta una programación nativa, así que guarde la fecha prevista en su propia cola de tareas y llame a POST /v2/{account_id}/posts en el momento indicado.
Sí. Con la API de Meta, una app solo puede modificar las publicaciones de Página que creó, y elimina una publicación con DELETE /{page_post_id}. Con Unipile, PATCH /v2/{account_id}/posts/{post_id} modifica el texto y DELETE envía la publicación a la papelera, donde su autor puede leerla durante 30 días.
No. Meta declaró obsoletos la Groups API y el permiso publish_to_groups con la Graph API v19.0 en enero de 2024, y Unipile tampoco permite publicar en Grupos.
Puede publicar un vídeo. Con Unipile, una publicación admite un vídeo, que Facebook procesa de forma asíncrona. Los Reels no están documentados y las Stories no son compatibles.
Con la Graph API de Meta, llame a GET /{page_id}/feed con un Page access token y los permisos pages_read_engagement y pages_read_user_content; limit devuelve como máximo 100 publicaciones por petición. Con Unipile, llame a GET /v2/{account_id}/users/{user_id}/posts con el ID de una Página activada y siga next_cursor para obtener la página siguiente.
No. Unipile es una empresa independiente, no un Meta Partner, y no cuenta con el respaldo, el patrocinio ni la aprobación de Meta. Las publicaciones que publica su app proceden de las propias cuentas y Páginas de Facebook de sus usuarios. Facebook es una marca comercial de Meta Platforms, Inc.
No. Para publicar o leer publicaciones a través de Unipile, sus usuarios conectan su propia cuenta de Facebook, y las Páginas que gestionan, mediante la autenticación alojada. Se ahorra la app de Meta, los permisos de publicación y el App Review que exige la vía de la Pages API.
Unipile se ha diseñado en el espíritu de la Digital Markets Act (Ley de Mercados Digitales): cada usuario conecta su propia cuenta y decide lo que se publica, y Unipile actúa en su nombre sin almacenar perfiles de usuario. Más información en nuestra página sobre la Digital Markets Act.
Sí. Cada publicación que su app publica o lee pasa por una cuenta que sigue sujeta a las Condiciones de servicio de Meta. Limítese a usos legítimos, como publicar el propio contenido de sus usuarios y mostrar las publicaciones que su cuenta ya ve cuando lo solicitan; el spam y la automatización no autorizada pueden provocar la restricción de las cuentas.
¿Aún tiene preguntas? Nuestro equipo está aquí para ayudarle.
Hable con un experto