Posts
Publier sur Threads via l'API
Un POST /posts avec format feed publie sur le compte Threads que le client a connecté. Vous n'implémentez pas l'OAuth de Threads et ne stockez aucun token : vous envoyez le contenu et Connect publie en arrière-plan. Le même endpoint sert les autres réseaux.
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": "We shipped v2 of the dashboard. What do you want to see in v3?",
"threads": {
"reply_control": "accounts_you_follow",
"topic_tag": "saas",
"first_comment": "Full changelog on our site."
}
}Ce que vous pouvez faire
- Publier du texte seul, avec une légende de 500 caractères maximum.
- Publier jusqu'à 20 images ou vidéos dans un même post.
- Définir qui peut répondre avec reply_control.
- Joindre un lien avec aperçu à un post texte avec link_attachment.
- Taguer le post avec un topic_tag et publier un first_comment juste après.
Règles et limites
- Sur Threads, seul le format feed existe. Il faut une légende ou un média.
- link_attachment ne vaut que sur un post sans média. topic_tag n'accepte ni point ni &.
- POST /posts répond 202 et la publication se fait ensuite. Suivez-la avec GET /posts/{uuid}.
- external_reference est obligatoire. Renvoyer la même référence sur le même compte, pendant la publication ou après, retourne 409.
- Le header Idempotency-Key (255 caractères max) renvoie le post déjà enregistré si la même requête est répétée.
Champs principaux
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| external_reference | string | Oui | L'id du post dans votre système (100 caractères max). Évite de publier deux fois le même post sur le même compte. |
| format | string | Oui | Toujours feed sur Threads. |
| caption | string | Non | Le texte du post, 500 caractères max. Obligatoire sans média. |
| media | array | Non | Jusqu'à 20 images ou vidéos, dans l'ordre. À omettre pour un post texte seul. |
| threads.reply_control | string | Non | Qui peut répondre : everyone, accounts_you_follow, mentioned_only, parent_post_author_only ou followers_only. |
| threads.link_attachment | string | Non | Lien avec aperçu joint au post. Uniquement sur un post sans média. |
| threads.topic_tag | string | Non | Tag de sujet, 50 caractères max, sans point ni &. |
| threads.first_comment | string | Non | Réponse publiée par le compte lui-même juste après le post, 500 caractères max. |
Pour qui
Outil de réseaux sociaux
Votre produit de planification envoie le post sur Threads avec Instagram et LinkedIn, par le même endpoint.
Agent IA qui publie
Un agent rédige le texte et le publie sur le Threads du client, en choisissant reply_control pour limiter les réponses.
CRM avec contenu
Un CRM publie les nouveautés de ses clients sur Threads et utilise first_comment pour placer le lien juste dessous.
Fonctionne avec
Threads
Questions fréquentes
Puis-je publier uniquement du texte sur Threads ?
Oui. Envoyez format feed et caption, sans media. La légende va jusqu'à 500 caractères.
Combien de médias dans un post Threads ?
Jusqu'à 20 images ou vidéos par post.
Comment savoir si le post est sorti ?
POST /posts répond 202 avec le post en created. Interrogez GET /posts/{uuid} jusqu'à ce que status soit published ou failed.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
