Posts
Publier des reels sur Instagram via l'API
Avec format reels et une vidéo dans media, Connect publie un reel sur le compte Instagram connecté par votre client. Un seul appel pour tous les comptes, sans app review et sans stocker de tokens.
L'appel
POST /api/posts?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>
{
"external_reference": "reel-310",
"format": "reels",
"caption": "Bastidores da campanha #reels",
"media": [
{
"type": "video",
"url": "https://cdn.example.com/reel.mp4"
}
],
"instagram": {
"share_to_feed": true,
"cover_url": "https://cdn.example.com/capa.jpg",
"first_comment": "Qual parte você mais gostou?"
}
}Ce que vous pouvez faire
- Publier un reel à partir d'une URL de vidéo https:// publique.
- Choisir une image de couverture avec instagram.cover_url.
- Décider si le reel apparaît aussi dans la grille du profil avec instagram.share_to_feed.
- Utiliser un audio Instagram avec audio_id et régler audio_volume et video_volume.
- Ajouter des collaborateurs, un lieu, un premier commentaire et désactiver les commentaires.
Règles et limites
- Reels accepte exactement 1 vidéo.
- La légende va jusqu'à 2200 caractères, avec au plus 30 hashtags et 20 mentions.
- share_to_feed vaut true par défaut.
- audio_volume et video_volume exigent audio_id.
- La réponse est 202 : la publication tourne en arrière-plan et vous la suivez avec GET /posts/{uuid}.
- external_reference est obligatoire (409 si une publication identique existe) et Idempotency-Key, 255 caractères max, renvoie le post déjà enregistré avec 200 lors du rejeu.
Champs principaux
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| external_reference | string | Oui | L'id du post dans votre système (100 caractères max). Empêche de publier deux fois le même post sur le même compte. |
| format | string | Oui | Format du post. Sur Instagram : feed, reels ou story. Sur Facebook : feed, reels ou story. |
| caption | string | Non | Légende. Sur Instagram, jusqu'à 2200 caractères, 30 hashtags et 20 mentions. Les stories n'ont pas de légende. |
| media | array | Oui | Liste des médias, dans l'ordre. Chaque élément a type et url. |
| media.url | string | Oui | URL https:// publique que le réseau peut télécharger (2048 caractères max). |
| instagram.share_to_feed | boolean | Non | Si le reel apparaît aussi dans la grille du profil. Reels uniquement. |
| instagram.cover_url | string | Non | URL https:// de l'image de couverture du reel. Reels uniquement. |
| instagram.audio_id | string | Non | Id d'un audio Instagram pour le reel. Reels uniquement. |
Pour qui
Outil de vidéo courte
Votre éditeur exporte la vidéo et publie le reel directement sur le compte de l'utilisateur, avec couverture et légende définies sur le moment.
Agence avec beaucoup de clients
Un seul flux publie le même reel sur des dizaines de comptes Instagram connectés, chacun avec son customer_integration.
Agent IA de réseaux sociaux
Un agent génère la vidéo, choisit la couverture et publie le reel, avec le premier commentaire déjà prêt.
Fonctionne avec
Instagram Business
Instagram
Questions fréquentes
Puis-je publier une vidéo seule en feed ?
Non. Une vidéo seule doit passer en reels ; feed sert pour 1 image ou un carrousel de 2 à 10 médias.
Le reel apparaît-il dans la grille du profil ?
Par défaut oui, car share_to_feed vaut true. Envoyez instagram.share_to_feed à false pour l'éviter.
Cela marche avec les comptes instagram et instagram_business ?
Oui. Les deux connexions acceptent le même POST /posts et le même bloc instagram.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
