
Guides d'intégration
Guide de l'API LinkedIn
Guide de l'API Email
Guide de l'API WhatsApp
Contacter l'équipe commerciale
Publier, modifier, supprimer et lire des posts Facebook par API en 2026, via la Pages API de Meta ou les comptes que vos utilisateurs connectent eux-mêmes.
posts
PATCHposts/{id}
DELETEposts/{id}
200 OK
Une API Facebook post permet à votre app de publier, modifier, supprimer et lire des posts Facebook avec des requêtes HTTP. Il existe deux voies : la Pages API de Meta, qui ne publie que sur des Pages Facebook via une app Meta et des Page access tokens, ou un compte connecté, où chaque utilisateur relie son propre compte Facebook et votre app publie en tant que son profil ou en tant qu'une Page qu'il gère.
Pour la vue d'ensemble de la plateforme de Meta, voyez comment les API Facebook s'articulent.
Publier un post Facebook en trois étapes
Connecter le compteVotre utilisateur connecte son compte Facebook, et les Pages qu'il gère, via Hosted Auth. Ni app Meta, ni App Review.
Créer le postEnvoyez POST /v2/{account_id}/posts avec votre clé dans X-API-KEY et un texte ou des pièces jointes.
Modifier, supprimer ou publier en tant que PageAppelez PATCH ou DELETE sur le post, ou ajoutez post_as avec l'ID d'une Page activée.
Meta n'a aucun produit appelé « Post API ». Les posts Facebook sont des objets de la Graph API, et les apps les publient via la Pages API, qui n'écrit que sur des Pages Facebook. Depuis 2018, une app tierce ne peut plus publier sur le profil personnel d'une personne.
En pratique, « API Facebook post », ou ce que les développeurs appellent l'API Facebook pour les posts, désigne des appels de la Graph API sur un nœud post et sur l'arête /feed d'une Page. Nœuds, arêtes et tokens : voir notre présentation de la Graph API de Facebook.
{page_id}_{post_id}Le nœud post. Son ID associe l'ID de l'auteur et l'ID du post./{page_id}/feedL'arête qui liste les posts d'une Page et en reçoit de nouveaux.messageLe texte du post.created_timeLa date de publication du post./{page_id}/photosL'arête des posts photo.Envoyez POST /{page_id}/feed avec un message (et éventuellement un link), en utilisant un Page access token (voir le guide de l'API Pages Facebook et notre guide token d'accès de l'API Facebook). Meta renvoie l'ID du nouveau post sous la forme {"id": "{page_post_id}"}.
Créez une app et ajoutez Facebook Login for Business.
pages_show_listDemandez les droits de publication, puis passez l'App Review.
pages_manage_postsObtenez le Page token à partir du user token.
GET /me/accountsPubliez sur le fil de la Page avec le Page token.
POST /{page_id}/feedpages_manage_posts, pages_read_engagement et pages_show_list, de la part d'une personne qui peut effectuer la tâche CREATE_CONTENT sur la Page.pages_manage_engagement et pages_read_user_engagement, avec les tâches CREATE_CONTENT, MANAGE et MODERATE.publish_video.La requête et sa réponse se trouvent dans les onglets Meta cURL et Meta Python du bloc de code ci-dessous, à côté de la version Unipile.
| Paramètre | Rôle |
|---|---|
message | Le texte du post |
link | Une URL affichée avec un aperçu du lien |
published | false pour un post non publié ou programmé |
scheduled_publish_time | Date de publication, de 10 minutes à 30 jours à l'avance |
false pour un post non publié ou programméPhotos et vidéo. Une photo seule passe par /{page_id}/photos. Pour un post à plusieurs photos, envoyez chaque photo sur cette arête avec published=false, puis publiez-les ensemble sur /{page_id}/feed avec attached_media et les ID renvoyés ; les photos non publiées sont supprimées au bout de 24 heures. Les vidéos passent par la Video API avec publish_video.
Source : la documentation des posts de la Pages API, le guide de démarrage de la Pages API, la référence du feed de Page et la référence des photos de Page de Meta (Graph API v27.0). Dernière vérification : 17 novembre 2026.
Trois règles de la Graph API encadrent tout projet de publication sur Facebook : les apps ne peuvent pas publier sur des profils personnels, ne peuvent pas publier dans des groupes, et ne peuvent modifier que les posts de Page qu'elles ont elles-mêmes créés.
Meta a retiré la permission publish_actions aux apps le 1er août 2018. Détails dans les limites de l'API Facebook officielle.
La Groups API et publish_to_groups ont été dépréciées avec la Graph API v19.0 le 23 janvier 2024.
Selon Meta, une app ne peut modifier un post de Page que s'il a été créé avec cette app.
Votre app ne peut pas modifier un post rédigé sur facebook.com ou avec un autre outil : un produit qui modifie des posts doit donc les créer.
Les premières erreurs que vous rencontrerez. Avec la Graph API, le code 190 signifie que l'access token a expiré, les codes 200 à 299 qu'une permission n'a pas été accordée ou a été retirée, et 4 ou 17 qu'il y a trop d'appels. Avec Unipile, publier au nom d'une Page non activée renvoie 403 api/insufficient_permissions.
Sources : la documentation des posts de la Pages API, le changelog de Facebook Login, l'annonce de la Graph API v19.0 et la gestion des erreurs de la Graph API de Meta. Dernière vérification : 17 novembre 2026.
Avec Unipile, chaque utilisateur connecte son compte Facebook via Hosted Auth, et votre app obtient un account_id. Vous créez un post avec POST /v2/{account_id}/posts, modifiez son texte avec PATCH et le supprimez avec DELETE. Un post supprimé part à la corbeille, où son auteur peut encore le lire pendant 30 jours.
Pas d'app Meta ni d'App Review de votre côté : chaque appel envoie votre clé API dans X-API-KEY et s'exécute pour le compte de l'utilisateur qui a connecté le compte. Les onglets Meta montrent la même publication avec la Graph API et un Page access token, pour comparaison.
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()
Champs de la requête dans Create posts, modification et corbeille dans Edit and delete posts. Les onglets Meta suivent le guide des posts de la Pages API et la référence Post, v27.0, vérifiés le 17 nov. 2026.
| Champ ou cas | Règle |
|---|---|
text et attachments | Texte ou pièce jointe obligatoire. Fichiers en base64, ou en multipart pour les gros fichiers |
| Images | Plusieurs images forment un album |
| Vidéo | Une vidéo par post, jamais mélangée à des images |
quoted_post_id | Partage un post, sans pièces jointes |
| Mentions | @ suivi d'un ID ou d'un nom d'utilisateur dans text |
can_read | anyone (par défaut) ou relations_only |
can_comment | Uniquement anyone, sinon 400 |
@ suivi d'un ID ou d'un nom d'utilisateur dans textanyone (par défaut) ou relations_onlyanyone, sinon 400Vos utilisateurs publient depuis leurs propres comptes
Unipile n'est ni un produit Meta, ni un Meta Partner. Vos utilisateurs connectent leurs propres comptes, décident de ce qui est publié et restent soumis aux conditions de Meta.
Ajoutez post_as avec l'ID d'une Page que le compte administre et qui est activée sur ce compte. Aucun compte séparé à connecter : le même account_id couvre le profil de l'utilisateur et ses Pages.
PAGE_<page_id>_INBOX.403 api/insufficient_permissions.Étapes de configuration dans la documentation Facebook Pages.
POST /v2/{account_id}/posts
{
"text": "Hello from our Page!",
"post_as": "1357020157484056"
}
Avec l'API de Meta, appelez GET /{page_id}/feed avec un Page access token. Avec Unipile, appelez GET /v2/, où user_id vaut me, l'ID d'une Page activée, ou l'ID d'une autre personne ou Page dont le compte connecté voit déjà les posts sur Facebook.
Usage type : l'activité récente dans un CRM ou un outil social, pour les comptes que vos utilisateurs ont connectés. La lecture des posts d'autrui reste limitée à ce que le compte connecté voit déjà sur Facebook, et se fait à la demande de l'utilisateur.
Ravie de rejoindre l'équipe de Lisbonne le mois prochain !
Les slides de mon talk sur les outils de support sont en ligne.
Randonnée du week-end avec l'équipe.
next_cursor: "QVFIUm..."v2/{ACCOUNT_ID}/users/{USER_ID}/posts
200 OK
/v2/{account_id}/users/{user_id}/posts me, l'ID d'une Page activée, ou l'ID d'une autre personne ou Page, limité aux posts que le compte connecté voit déjà/v2/{account_id}/posts/{post_id} <author id>_<post id>account_idFacebook renvoie jusqu'à 3 posts par page, quelle que soit la valeur de limit envoyée. Suivez next_cursor pour obtenir la page suivante ; il n'y a pas d'offset. Détails dans List user posts.
La Pages API de Meta convient à une app qui publie sur les Pages de sa propre entreprise, ou sur des Pages clientes qui passent par votre app Meta. Un compte connecté convient à un produit SaaS où chaque utilisateur publie depuis son propre profil et ses Pages, sans app Meta de votre côté.
| Critère | Pages API de Meta | Compte connecté (Unipile) |
|---|---|---|
| Comptes couverts | Les Pages que gèrent les utilisateurs de votre app | Le profil de l'utilisateur et les Pages qu'il gère |
| Mise en place de votre côté | App Meta, Facebook Login, App Review | Clé API et Hosted Auth, sans App Review |
| Identifiants | Un Page token par Page | Un account_id par utilisateur |
| Posts sur le profil personnel | Impossible depuis 2018 | Oui, en tant qu'utilisateur connecté |
| Modification des posts | Uniquement les posts créés avec votre app | Texte d'un post, par post_id |
| Groupes | Dépréciés en v19.0 | Non pris en charge |
| Stories | Hors du périmètre de ce guide | Non pris en charge |
| Programmation | scheduled_publish_time, de 10 minutes à 30 jours | Non documentée, utilisez votre propre file de tâches |
| Autres réseaux | Pages Facebook uniquement | Même API pour LinkedIn, Instagram, WhatsApp et d'autres |
account_id par utilisateurpost_idscheduled_publish_time, de 10 minutes à 30 joursLa même connexion couvre les conversations : voir l'API Facebook et Messenger d'Unipile, comment connecter un compte Facebook personnel, et les prix de l'API Facebook Messenger.
L'API Facebook post prend tout son sens dans les produits où les gens travaillent déjà, chaque utilisateur publiant depuis ses propres comptes.
Les community managers publient et corrigent les posts de leur profil et de leurs Pages, à côté de leurs messages.
À la demande du commercial, la fiche d'un contact affiche les derniers posts de la personne, limités à ce que le compte connecté du commercial voit déjà sur Facebook.
Un agent rédige un post, l'utilisateur le valide, et ce n'est qu'ensuite que votre app envoie le POST.
Le même modèle de posts fonctionne pour d'autres réseaux : notre guide de l'API Instagram couvre l'autre réseau de Meta.
Publiez des posts Facebook depuis votre app
Utilisez la Pages API de Meta pour vos propres Pages. Quand chaque utilisateur publie, modifie et lit des posts depuis son propre profil et ses Pages, connectez leurs comptes via Unipile : une seule API REST.
Chaque utilisateur connecte son propre compte, sans stockage de profils. Unipile n'est pas partenaire Meta. En savoir plus
Tous les endpoints de l'API Facebook au même endroit
Les posts ne sont qu'une partie du tableau. Consultez tous les endpoints Facebook disponibles avec Unipile, des messages aux profils, ou lisez le guide complet de l'API Facebook.
Réponses rapides sur les Pages, les photos, la programmation, les modifications, les groupes, la vidéo et la lecture des posts.
Avec la Pages API de Meta, envoyez POST /{page_id}/feed avec un message, en utilisant un Page access token et les permissions pages_manage_posts, pages_read_engagement et pages_show_list. Avec Unipile, l'utilisateur connecte son compte Facebook une seule fois, et vous appelez POST /v2/{account_id}/posts avec post_as renseigné avec l'ID d'une Page qu'il gère et qu'il a activée.
Avec Unipile, plusieurs images dans un même post s'affichent sous forme d'album, et un post peut contenir à la place une vidéo, jamais les deux. Avec la Pages API de Meta, les photos sont publiées via l'arête /{page_id}/photos.
La Pages API de Meta le permet : créez le post avec published à false et un scheduled_publish_time compris entre 10 minutes et 30 jours à l'avance, selon le guide de la Pages API (la référence Page feed indique 75 jours ; testez sur votre version). Unipile ne documente pas de programmation native : conservez la date prévue dans votre propre file de tâches et appelez POST /v2/{account_id}/posts le moment venu.
Oui. Avec l'API de Meta, une app ne peut modifier que les posts de Page qu'elle a créés, et supprime un post avec DELETE /{page_post_id}. Avec Unipile, PATCH /v2/{account_id}/posts/{post_id} modifie le texte, et DELETE envoie le post à la corbeille, où son auteur peut le lire pendant 30 jours.
Non. Meta a déprécié la Groups API et la permission publish_to_groups avec la Graph API v19.0 en janvier 2024, et Unipile ne prend pas non plus en charge la publication dans les groupes.
Vous pouvez publier une vidéo. Avec Unipile, un post accepte une vidéo, que Facebook traite de façon asynchrone. Les Reels ne sont pas documentés et les Stories ne sont pas prises en charge.
Avec la Graph API de Meta, appelez GET /{page_id}/feed avec un Page access token et les permissions pages_read_engagement et pages_read_user_content ; limit renvoie au plus 100 posts par requête. Avec Unipile, appelez GET /v2/{account_id}/users/{user_id}/posts avec l'ID d'une Page activée, puis suivez next_cursor pour obtenir la page suivante.
Non. Unipile est une entreprise indépendante, ce n'est pas un Meta Partner, et Unipile n'est ni soutenu, ni sponsorisé, ni approuvé par Meta. Les posts que publie votre app proviennent des propres comptes et Pages Facebook de vos utilisateurs. Facebook est une marque de Meta Platforms, Inc.
Non. Pour publier ou lire des posts via Unipile, vos utilisateurs connectent leur propre compte Facebook, et les Pages qu'ils gèrent, via l'authentification hébergée. Vous vous passez de l'app Meta, des permissions de publication et de l'App Review qu'exige la voie Pages API.
Unipile est conçu dans l'esprit du Digital Markets Act : chaque utilisateur connecte son propre compte et décide de ce qui est publié, et Unipile agit en son nom sans stocker de profils utilisateurs. Plus de détails sur notre page Digital Markets Act.
Oui. Chaque post que votre app publie ou lit passe par un compte qui reste soumis aux conditions d'utilisation de Meta. Tenez-vous-en aux usages légitimes, comme publier le propre contenu de vos utilisateurs et afficher, à leur demande, des posts que leur compte voit déjà ; le spam et l'automatisation non autorisée peuvent entraîner la restriction des comptes.
Encore des questions ? Notre équipe est là pour vous aider.
Parler à un expert