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

ChampTypeObligatoireDescription
external_referencestringOuiL'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.
formatstringOuiFormat du post. Sur Instagram : feed, reels ou story. Sur Facebook : feed, reels ou story.
captionstringNonLégende. Sur Instagram, jusqu'à 2200 caractères, 30 hashtags et 20 mentions. Les stories n'ont pas de légende.
mediaarrayOuiListe des médias, dans l'ordre. Chaque élément a type et url.
media.urlstringOuiURL https:// publique que le réseau peut télécharger (2048 caractères max).
instagram.share_to_feedbooleanNonSi le reel apparaît aussi dans la grille du profil. Reels uniquement.
instagram.cover_urlstringNonURL https:// de l'image de couverture du reel. Reels uniquement.
instagram.audio_idstringNonId 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.

Voir aussi

Voir tout ce que vous pouvez faire avec Posts

Voyez Connect appliqué à votre produit.

Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.