Publications
Une publication (post), c’est une publication sur un canal. Publier la même
chose sur deux canaux crée deux publications qui partagent un group : c’est ce
groupe que le calendrier affiche en une seule carte, et c’est lui que prennent
les routes de suppression. Le composeur, l’agent, la
CLI et vos propres scripts passent tous par les mêmes routes et la même
validation.
POST /posts créer, planifier, publier tout de suite, ou mettre à jourGET /posts lister une plage de datesPUT /posts/{id}/status brouillon ⇄ planifiéeGET /posts/{id}/missing éléments récents du fournisseur, pour réparer un releaseId manquantPUT /posts/{id}/release-id enregistrer l’identifiant du fournisseurDELETE /posts/{id} supprimer une publication et son groupeDELETE /posts/group/{group} supprimer un groupeCréer une publication
Section intitulée « Créer une publication »POST /postsCorps de la requête
Section intitulée « Corps de la requête »| Champ | Type | Obligatoire | Description |
|---|---|---|---|
type |
string |
Oui | draft, schedule, now ou update (voir plus bas) |
date |
string |
Oui | Date de publication, UTC ISO 8601. Ignorée par now, qui publie immédiatement |
shortLink |
boolean |
Oui | Réécrire les liens du texte en liens courts suivis |
tags |
Tag[] |
Oui | [] s’il n’y en a pas |
posts |
PostItem[] |
Oui | Au moins un |
order |
string |
Non | Ordre des publications |
inter |
number |
Non | Répéter tous les n jours (publication récurrente) |
creationMethod |
string |
Non | API (par défaut) ou CLI : l’étiquette de la publication dans les analyses |
type décide de la suite :
type |
Effet |
|---|---|
schedule |
Mise en file, publiée à date |
now |
Publiée immédiatement ; date est remplacée par l’heure actuelle |
draft |
Enregistrée, rien ne se lance. Validée quand même comme une publication planifiée |
update |
Réécrit une publication existante (value[].id la désigne, group son groupe) sans relancer son workflow de publication |
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
value |
string |
Oui | Nom du tag |
label |
string |
Oui | Libellé du tag |
PostItem
Section intitulée « PostItem »| Champ | Type | Obligatoire | Description |
|---|---|---|---|
integration |
{ id } |
Oui | Le canal |
value |
PostContent[] |
Oui | Au moins un. Le premier est la publication ; les suivants partent en commentaires sous elle |
settings |
object |
Oui | Réglages du fournisseur, avec __type qui nomme la plateforme. Validés quel que soit le type, brouillons compris |
group |
string |
Non | Reprendre un identifiant de groupe pour ajouter cette publication à un groupe existant (avec update) |
PostContent
Section intitulée « PostContent »| Champ | Type | Obligatoire | Description |
|---|---|---|---|
content |
string |
Oui | Le texte. Le HTML est accepté et assaini |
image |
Media[] |
Oui | [] s’il n’y en a pas. Instagram et TikTok en demandent au moins un |
id |
string |
Non | La publication que cet élément met à jour (type: update) |
delay |
number |
Non | Minutes d’attente avant de publier ce commentaire après l’élément précédent |
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
id |
string |
Oui | Identifiant du média, issu d’un téléversement |
path |
string |
Oui | URL publique qui se termine par .png, .jpg, .jpeg, .gif, .webp ou .mp4 |
alt |
string |
Non | Texte alternatif |
thumbnail |
string |
Non | La couverture d’une vidéo : l’URL d’un JPEG, idéalement 1080×1920, 8 Mo au plus. Un reel Instagram sort avec elle comme couverture (l’image de la grille du profil). N’importe quelle URL publique, signée comprise : UseNadia en garde une copie à la programmation. Une couverture qu’il ne peut pas télécharger, ou qui n’est pas un JPEG, fait refuser la publication avec un 400 qui la nomme. Voir Instagram |
Réglages par plateforme
Section intitulée « Réglages par plateforme »settings.__type doit correspondre à la plateforme du canal. Les plateformes
sur lesquelles on publie ont chacune leur page :
Instagram (instagram-standalone),
TikTok (tiktok),
X (x, publication seule, 10 posts avec lien par mois et par compte),
LinkedIn (linkedin),
YouTube (youtube, une vidéo par publication) et
Threads (threads, parties suivantes en réponses enchaînées).
Exemples
Section intitulée « Exemples »{ "type": "schedule", "date": "2026-11-03T10:00:00.000Z", "shortLink": false, "tags": [], "posts": [ { "integration": { "id": "your-instagram-id" }, "value": [ { "content": "Trois choses que personne ne dit sur Malte.", "image": [{ "id": "med-123", "path": "https://media.usenadia.com/reel.mp4" }] } ], "settings": { "__type": "instagram-standalone", "post_type": "post" } } ]}{ "type": "now", "date": "2026-11-03T10:00:00.000Z", "shortLink": false, "tags": [], "posts": [ { "integration": { "id": "your-tiktok-id" }, "value": [ { "content": "Trois choses que personne ne dit sur Malte. #malte #expat", "image": [{ "id": "med-123", "path": "https://media.usenadia.com/reel.mp4" }] } ], "settings": { "__type": "tiktok", "content_posting_method": "DIRECT_POST", "privacy_level": "PUBLIC_TO_EVERYONE", "duet": true, "stitch": true, "comment": true, "autoAddMusic": "no", "brand_content_toggle": false, "brand_organic_toggle": false } } ]}{ "type": "schedule", "date": "2026-11-03T10:00:00.000Z", "shortLink": false, "tags": [{ "value": "malte", "label": "Malte" }], "posts": [ { "integration": { "id": "your-instagram-id" }, "value": [ { "content": "Trois choses que personne ne dit sur Malte.", "image": [{ "id": "med-123", "path": "https://media.usenadia.com/reel.mp4" }] }, { "content": "Le guide complet est en bio.", "image": [], "delay": 5 } ], "settings": { "__type": "instagram-standalone", "post_type": "post" } } ]}201 : une entrée par publication créée.
[ { "postId": "cm4post0001", "integration": "your-instagram-id" }]| Statut | Quand |
|---|---|
400 |
Un champ est mal formé, un identifiant de canal est inconnu, ou la plateforme refuse la publication. Un refus de la plateforme porte provider, name (le canal) et error (ce qu’il faut corriger) |
413 |
Corps de plus de 50 Mo : le média a été intégré au lieu d’être téléversé d’abord |
429 |
La limite horaire |
Une publication qui nomme une automatisation
dans ses réglages Instagram est aussi vérifiée à la création : une variable
manquante, ou des mots-clés envoyés sans automationFlowId, donnent un 400.
Lister les publications
Section intitulée « Lister les publications »GET /posts?startDate=2026-10-01T00:00:00.000Z&endDate=2026-10-31T23:59:59.000Z| Paramètre | Obligatoire | Description |
|---|---|---|
startDate |
Oui | UTC ISO 8601 |
endDate |
Oui | UTC ISO 8601 |
integration |
Non | Seulement ce canal |
workspace |
Non | Seulement les canaux de ce workspace (un id renvoyé par GET /workspaces, voir Workspaces et périmètre) |
group, customer |
Non | Dépréciés : même effet que workspace |
Réponse 200, { "posts": [ … ] }, une ligne par publication (les
commentaires ne sont pas listés ; une publication récurrente apparaît une fois
par occurrence, chacune avec actualDate) :
| Champ | Type | Description |
|---|---|---|
id |
string |
|
content |
string |
Le texte, en HTML |
publishDate |
string |
UTC |
state |
string |
QUEUE, PUBLISHED, ERROR, DRAFT, ou SENT_UNCONFIRMED (une publication TikTok envoyée dans la boîte de réception de l’app, pas encore publiée à la main) |
releaseURL |
string | null |
URL de la publication en ligne |
releaseId |
string | null |
Identifiant fournisseur de la publication en ligne ; missing quand le fournisseur n’en a renvoyé aucun |
group |
string |
Ce que prennent les routes de suppression |
intervalInDays |
number | null |
Pour une publication récurrente |
creationMethod |
string |
Sa provenance (API, CLI…) |
tags |
[{ tag }] |
Chaque tag est l’enregistrement du tag (name, color) |
integration |
object |
id, providerIdentifier, name, picture |
Un téléversement TikTok que TikTok traite encore quand la publication se
termine (au bout d’environ 20 minutes) n’est pas une erreur : la publication
passe en SENT_UNCONFIRMED avec le publish_id de TikTok comme releaseId, et
UseNadia redemande à TikTok toutes les 10 minutes pendant 24 heures. Ensuite, la
publication passe en PUBLISHED avec l’identifiant de la vidéo, reste en
SENT_UNCONFIRMED avec releaseId: "missing" (un brouillon dans la boîte de
réception TikTok, ou aucune réponse en 24 heures), ou passe en ERROR avec la
raison donnée par TikTok.
La liste ne contient pas de settings. Les réglages d’une publication ne se
lisent pas par l’API aujourd’hui.
Changer le statut
Section intitulée « Changer le statut »PUT /posts/{id}/status{ "status": "schedule" }schedule passe l’état à QUEUE et (re)lance le workflow de publication à la
date enregistrée ; draft le passe à DRAFT et arrête le workflow. La date ne
change pas. Réponse 200 :
{ "id": "cm4post0001", "state": "QUEUE" }Une publication inconnue donne un 400 (Post not found).
Réparer un identifiant de publication manquant
Section intitulée « Réparer un identifiant de publication manquant »Il arrive qu’une publication parte mais que la plateforme ne renvoie aucun
identifiant exploitable : la publication a alors releaseId: "missing", et ses
analyses ne peuvent pas être lues. Deux routes la réparent.
GET /posts/{id}/missingListe les éléments récents du compte chez le fournisseur, pour reconnaître le
bon. Réponse 200 :
[ { "id": "7321456789012345678", "url": "https://p16-sign.tiktokcdn-us.com/obj/cover.jpeg" }]La réponse est [] quand la publication n’est pas dans cet état, ou quand le
fournisseur ne sait pas lister ses éléments : aujourd’hui, seul TikTok le sait.
PUT /posts/{id}/release-id{ "releaseId": "7321456789012345678" }Enregistre l’identifiant sur la publication. Une publication TikTok en
SENT_UNCONFIRMED passe en PUBLISHED, et la
carte de contenu liée à son groupe suit.
Réponse 200 : la ligne de la publication.
Supprimer
Section intitulée « Supprimer »DELETE /posts/{id}DELETE /posts/group/{group}Les deux suppriment le groupe entier : la publication désignée, chaque canal
avec lequel elle a été publiée, et ses commentaires. Tout workflow de
publication en cours est arrêté. Réponse 200 :
{ "id": "cm4post0001" }Un 404 sur une suppression veut dire que la publication n’existait déjà
plus : il s’ignore sans risque.