FR
Guide développeur

API Facebook post : publier, modifier et lire des posts depuis votre app

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.

Votre app Connecté
Publier en tant queFacebookNorthwind BakeryFacebookAnna Lee
Pain au levain frais chaque matin dès 7 h. Précommandes ouvertes vendredi.
Publier
Notre menu d'automne arrive lundiNorthwind Bakery · Page · Aujourd'huiPublié
Merci pour ces 10 belles années !Northwind Bakery · Page · 2 oct.Modifié
De retour du marchéAnna Lee · Personnel · 28 sept.Corbeille
POSTposts PATCHposts/{id} DELETEposts/{id} 200 OK
Réponse courte

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.

Avec Unipile

Publier un post Facebook en trois étapes

  1. Connecter le compteVotre utilisateur connecte son compte Facebook, et les Pages qu'il gère, via Hosted Auth. Ni app Meta, ni App Review.

  2. Créer le postEnvoyez POST /v2/{account_id}/posts avec votre clé dans X-API-KEY et un texte ou des pièces jointes.

  3. 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.

Définition

Qu'est-ce que l'API Facebook post ?

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.

Facebook Les posts dans la Graph API
{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.
Pages API de Meta

Comment publier un post sur une Page Facebook avec la Graph API ?

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}"}.

1

App Meta

Créez une app et ajoutez Facebook Login for Business.

pages_show_list
2

Permissions

Demandez les droits de publication, puis passez l'App Review.

pages_manage_posts
3

Page token

Obtenez le Page token à partir du user token.

GET /me/accounts
4

Publier

Publiez sur le fil de la Page avec le Page token.

POST /{page_id}/feed

Permissions et tâches de Page

  • Pour publier. La référence du feed de Page exige pages_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.
  • Pour gérer les posts et leur engagement. Le guide des posts de la Pages API ajoute pages_manage_engagement et pages_read_user_engagement, avec les tâches CREATE_CONTENT, MANAGE et MODERATE.
  • Pour la vidéo. Ajoutez 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ètres d'un post de Page

ParamètreRôle
messageLe texte du post
linkUne URL affichée avec un aperçu du lien
publishedfalse pour un post non publié ou programmé
scheduled_publish_timeDate de publication, de 10 minutes à 30 jours à l'avance
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

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.

Règles des posts

Ce que l'API de Meta ne permet pas de faire avec les posts

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.

Depuis 2018

Pas de posts sur les profils personnels

Meta a retiré la permission publish_actions aux apps le 1er août 2018. Détails dans les limites de l'API Facebook officielle.

Depuis 2024

Pas de posts dans les groupes

La Groups API et publish_to_groups ont été dépréciées avec la Graph API v19.0 le 23 janvier 2024.

Souvent oublié

Modifications limitées aux posts de votre app

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

Publier, modifier et supprimer des posts depuis un compte connecté

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.

Règles de contenu d'un post Facebook

Champ ou casRègle
text et attachmentsTexte ou pièce jointe obligatoire. Fichiers en base64, ou en multipart pour les gros fichiers
ImagesPlusieurs images forment un album
VidéoUne vidéo par post, jamais mélangée à des images
quoted_post_idPartage un post, sans pièces jointes
Mentions@ suivi d'un ID ou d'un nom d'utilisateur dans text
can_readanyone (par défaut) ou relations_only
can_commentUniquement anyone, sinon 400
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
Conformité

Vos 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.

Pages Facebook

Comment publier en tant que Page Facebook depuis un compte connecté ?

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.

  • Trouvez l'ID de la Page. Chaque Page activée possède une inbox nommée PAGE_<page_id>_INBOX.
  • Activez d'abord la Page. Publier en tant que Page non activée renvoie 403 api/insufficient_permissions.
  • Les modifications suivent l'auteur. Un post rédigé par une Page activée est modifié ou supprimé en tant que cette Page, sans champ supplémentaire.

Étapes de configuration dans la documentation Facebook Pages.

Publier en tant que Facebook
Anna LeeSans post_as : publie en tant que profilProfil
Northwind Bakerypost_as: "1357020157484056"Activée
Harbor CafePage non activée403
POST /v2/{account_id}/posts
{
  "text": "Hello from our Page!",
  "post_as": "1357020157484056"
}
Lire les posts

Comment récupérer les posts d'un profil ou d'une Page Facebook ?

Avec l'API de Meta, appelez GET /{page_id}/feed avec un Page access token. Avec Unipile, appelez GET /v2/{account_id}/users/{user_id}/posts, 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.

Julia Chen · Derniers posts Facebook

Ravie de rejoindre l'équipe de Lisbonne le mois prochain !

Il y a 2 jours41

Les slides de mon talk sur les outils de support sont en ligne.

30 oct.18

Randonnée du week-end avec l'équipe.

21 oct.27
Page suivantenext_cursor: "QVFIUm..."
GET v2/{ACCOUNT_ID}/users/{USER_ID}/posts 200 OK
Meta

Avec la Graph API de Meta

Endpoint
GET/{page_id}/feed
Token
Page access token
Tâche sur la Page
Le détenteur du token doit avoir CREATE_CONTENT, MANAGE ou MODERATE sur la Page
Permissions
pages_read_engagement et pages_read_user_content
Volume
Au plus 100 posts par requête avec limit, et environ 600 posts publiés et classés par an
Un seul post
GET /{post_id}, en choisissant des fields comme message, created_time ou permalink_url (voir les onglets Meta plus haut)
Posts d'un utilisateur
/{user_id}/posts avec un User access token et user_posts : uniquement les posts du propre journal de cet utilisateur et ceux où il est identifié

Sources : références Page feed, Post et User posts, v27.0, vérifiées le 17 nov. 2026.

Unipile

Avec Unipile

Lister les posts
GET/v2/{account_id}/users/{user_id}/posts
user_id
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à
Un seul post
GET/v2/{account_id}/posts/{post_id}
ID de post
<author id>_<post id>
Réactions et commentaires
Lister, ajouter et retirer des réactions sur un post, et gérer ses commentaires (voir l'API des commentaires Facebook), avec le même account_id
La pagination est fixée par Facebook

Facebook 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.

Décision

Pages API ou comptes connectés : lequel convient à votre produit ?

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èrePages API de MetaCompte connecté (Unipile)
Comptes couvertsLes Pages que gèrent les utilisateurs de votre appLe profil de l'utilisateur et les Pages qu'il gère
Mise en place de votre côtéApp Meta, Facebook Login, App ReviewClé API et Hosted Auth, sans App Review
IdentifiantsUn Page token par PageUn account_id par utilisateur
Posts sur le profil personnelImpossible depuis 2018Oui, en tant qu'utilisateur connecté
Modification des postsUniquement les posts créés avec votre appTexte d'un post, par post_id
GroupesDépréciés en v19.0Non pris en charge
StoriesHors du périmètre de ce guideNon pris en charge
Programmationscheduled_publish_time, de 10 minutes à 30 joursNon documentée, utilisez votre propre file de tâches
Autres réseauxPages Facebook uniquementMême API pour LinkedIn, Instagram, WhatsApp et d'autres
Comptes couverts
Pages API de MetaLes Pages que gèrent les utilisateurs de votre app
Compte connectéLe profil de l'utilisateur et les Pages qu'il gère
Mise en place de votre côté
Pages API de MetaApp Meta, Facebook Login, App Review
Compte connectéClé API et Hosted Auth, sans App Review
Identifiants
Pages API de MetaUn Page token par Page
Compte connectéUn account_id par utilisateur
Posts sur le profil personnel
Pages API de MetaImpossible depuis 2018
Compte connectéOui, en tant qu'utilisateur connecté
Modification des posts
Pages API de MetaUniquement les posts créés avec votre app
Compte connectéTexte d'un post, par post_id
Groupes
Pages API de MetaDépréciés en v19.0
Compte connectéNon pris en charge
Stories
Pages API de MetaHors du périmètre de ce guide
Compte connectéNon pris en charge
Programmation
Pages API de Metascheduled_publish_time, de 10 minutes à 30 jours
Compte connectéNon documentée, utilisez votre propre file de tâches
Autres réseaux
Pages API de MetaPages Facebook uniquement
Compte connectéMême API pour LinkedIn, Instagram, WhatsApp et d'autres

La 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.

Cas d'usage

Cas d'usage : des posts dans les CRM, les outils social media et les agents IA

L'API Facebook post prend tout son sens dans les produits où les gens travaillent déjà, chaque utilisateur publiant depuis ses propres comptes.

Inbox sociale et outils de community management

Les community managers publient et corrigent les posts de leur profil et de leurs Pages, à côté de leurs messages.

Activité dans le CRM

À 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.

Agents IA avec validation

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.

Commission européenne
Réglementé par l'UE Digital Markets Act (DMA)

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.

FAQ sur l'API Facebook post

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