Posts

Ajouter des collaborateurs aux posts Instagram via l'API

Avec instagram.collaborators, le post part avec d'autres comptes invités comme collaborateurs. Cela marche en feed, reels et story, avec le même appel POST /posts, sans app review.

L'appel

POST /api/posts?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>

{
  "external_reference": "post-5120",
  "format": "feed",
  "caption": "Parceria nova",
  "media": [
    {
      "type": "image",
      "url": "https://cdn.example.com/parceria.jpg"
    }
  ],
  "instagram": {
    "collaborators": [
      "marca_parceira",
      "criador_oficial"
    ]
  }
}

Ce que vous pouvez faire

  • Inviter des collaborateurs en feed, reels et story.
  • Envoyer les usernames sans @ : Connect retire le @ initial et met en minuscules.
  • Combiner avec les identifications d'utilisateurs dans media[].user_tags sur les médias.
  • Utiliser les comptes instagram et instagram_business.

Règles et limites

  • 5 collaborateurs au maximum par post.
  • Chaque username fait 30 caractères max : lettres, chiffres, point et underscore, sans @.
  • Sur une story, collaborators est la seule option du bloc instagram.
  • La réponse est 202 : le post est publié en arrière-plan. Suivez-le avec GET /posts/{uuid}.
  • external_reference est obligatoire et Idempotency-Key évite de dupliquer.

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.
mediaarrayOuiListe des médias, dans l'ordre. Chaque élément a type et url.
instagram.collaboratorsarrayNonJusqu'à 5 utilisateurs invités comme collaborateurs, sans @. Valable en feed, reels et story.
media.user_tagsarrayNonInstagram uniquement. Identifications d'utilisateurs (username, x et y), 20 max par média. Sur une image, x et y de 0 à 1 vont ensemble.

Pour qui

  • Posts de partenariat

    Marques et créateurs publient ensemble : le SaaS envoie le post depuis le compte de la marque et invite le créateur comme collaborateur.

  • Agences

    L'agence publie depuis le compte du client et invite son propre compte comme collaborateur.

  • Agent IA d'influence

    Un agent construit le post de campagne et invite automatiquement les profils de la liste de partenaires.

Fonctionne avec

  • Instagram Business
  • Instagram

Questions fréquentes

Combien de collaborateurs puis-je inviter ?

Jusqu'à 5 par post, en feed, reels ou story.

Dois-je envoyer le @ dans le username ?

Non. Envoyez-le sans @ ; un @ initial est retiré et la valeur est mise en minuscules.

Un collaborateur est-il la même chose qu'une identification ?

Non. Les collaborateurs vont dans le bloc instagram ; les identifications vont dans media[].user_tags.

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.