Canaux
Ce que l’application appelle un canal, l’API l’appelle une
integration : un compte social connecté. Son id est ce que toutes les
autres routes prennent comme integrationId ou integration.
GET /integrations vos canauxGET /social/{integration} commencer à en connecter un (URL OAuth)GET /is-connected vérifier la clé APIGET /integration-settings/{id} règles, longueur maximale, schéma des réglages, outilsPOST /integration-trigger/{id} lancer un outil du fournisseurGET /find-slot/{id} prochain créneau libre du canalGET /integrations/{id}/posting-times créneaux du canalPUT /integrations/{id}/posting-times remplacer les créneaux du canalGET /workspaces vos workspaces et leurs canauxGET /groups alias déprécié de /workspacesDELETE /integrations/{id} déconnecterLister les canaux
Section intitulée « Lister les canaux »GET /integrations| Paramètre | Obligatoire | Description |
|---|---|---|
workspace |
Non | Seulement les canaux de ce workspace (un id renvoyé par GET /workspaces) |
group |
Non | Déprécié : même effet que workspace |
Réponse 200 :
[ { "id": "cm4ean69r0003w8w1cdomox9n", "name": "maltaexpat", "identifier": "instagram-standalone", "picture": "https://media.usenadia.com/avatar.jpg", "disabled": false, "profile": "maltaexpat", "workspace": { "id": "cm9w0rk5p0001w8w1a2b3c4d5", "name": "Malta Expat" }, "customer": { "id": "cm9w0rk5p0001w8w1a2b3c4d5", "name": "Malta Expat" } }]| Champ | Type | Description |
|---|---|---|
id |
string |
L’id du canal |
name |
string |
Tel qu’affiché dans l’application |
identifier |
string |
La plateforme : instagram-standalone, tiktok, x, linkedin, youtube ou threads |
picture |
string | null |
URL de l’avatar |
disabled |
boolean |
Déconnecté, ou au-delà de l’offre |
profile |
string | null |
Le nom d’utilisateur sur la plateforme |
workspace |
object |
Le workspace du canal (chaque canal en a exactement un) : id, name |
customer |
object |
Déprécié : même valeur que workspace, gardé pour les SDK publiés |
Connecter un canal
Section intitulée « Connecter un canal »GET /social/{integration}Renvoie l’URL OAuth vers laquelle envoyer la personne. Connecter se passe dans le navigateur : la personne autorise l’accès sur la plateforme, qui la renvoie vers UseNadia, et le canal apparaît dans la liste ci-dessus.
| Paramètre | Où | Obligatoire | Description |
|---|---|---|---|
integration |
chemin | Oui | instagram-standalone, tiktok, x, linkedin, youtube ou threads |
refresh |
requête | Non | L’id d’un canal existant : le parcours renouvelle son jeton au lieu de créer un canal |
Réponse 200 :
{ "url": "https://www.instagram.com/oauth/authorize?client_id=…&state=…" }L’état derrière l’URL vit une heure. 400 quand l’identifiant est inconnu
(Integration not allowed) ; 500 quand l’URL de la plateforme n’a pas pu
être générée, ce qui arrive pour une plateforme enregistrée qui n’a pas
d’identifiants ici.
Vérifier la clé
Section intitulée « Vérifier la clé »GET /is-connectedRépond { "connected": true } avec une clé valide, 401 sans. Utile pour
tester rapidement une configuration ; la session MCP et la CLI le font pour
vous.
Réglages et outils d’un canal
Section intitulée « Réglages et outils d’un canal »GET /integration-settings/{id}Réponse 200 :
{ "output": { "rules": "Instagram should have at least one attachment, if it's a story, it can have only one picture", "maxLength": 2200, "settings": { "type": "object", "properties": { "post_type": { … } } }, "tools": [] }}| Champ | Description |
|---|---|
rules |
Les règles de publication de la plateforme, en une phrase |
maxLength |
Caractères autorisés dans le texte, compte vérifié pris en compte |
settings |
Le schéma JSON des réglages du fournisseur, ou la chaîne No additional settings required quand la plateforme n’en a pas |
tools |
Les outils du fournisseur que POST /integration-trigger/{id} peut lancer : methodName, description, dataSchema (key, type, description) |
404 quand le canal n’est pas le vôtre.
Lancer un outil du fournisseur
Section intitulée « Lancer un outil du fournisseur »POST /integration-trigger/{id}{ "methodName": "audioSearch", "data": { "q": "summer" } }Lance un outil que le fournisseur expose et répond 201 avec
{ "output": … }, la réponse brute du fournisseur. 404 quand le canal n’est
pas le vôtre ou que l’outil n’existe pas sur sa plateforme (Tool not found) ;
401 quand le jeton de la plateforme a expiré et n’a pas pu être renouvelé,
auquel cas le canal est déconnecté.
Prochain créneau libre
Section intitulée « Prochain créneau libre »GET /find-slot/{id}Parcourt les créneaux du canal à partir
de maintenant, jour par jour, en ne gardant que ceux qui servent ce jour de la
semaine, et répond le premier sans publication planifiée, 200 :
{ "date": "2026-10-21T10:00:00.000Z" }400 si le canal n’a aucun créneau (ou aucun jour coché).
Créneaux d’un canal
Section intitulée « Créneaux d’un canal »GET /integrations/{id}/posting-timesPUT /integrations/{id}/posting-timesUn créneau est une heure et les jours où il sert, en UTC : time en
minutes après minuit UTC (0 à 1439, 18 h 30 UTC = 1110), days de 0
(dimanche) à 6 (samedi), sans days = tous les jours. GET répond, et
PUT prend dans le corps { "times": [...] } puis répond, 200 :
{ "integrationId": "cm4ean69r0003w8w1cdomox9n", "times": [ { "time": 480, "days": [1, 3, 5] }, { "time": 1110 } ]}PUT remplace tous les créneaux du canal ; les publications déjà planifiées
ne bougent pas. 404 sur un canal qui n’est pas à vous.
Les workspaces et le filtre workspace
Section intitulée « Les workspaces et le filtre workspace »GET /workspacesRépond 200 avec vos workspaces, du plus ancien au plus récent. Un workspace
est un dossier de canaux : chaque canal est dans exactement un workspace, et
toute organisation en a au moins un (voir
Workspaces et périmètre).
[ { "id": "cm9w0rk5p0001w8w1a2b3c4d5", "name": "Malta Expat", "channels": ["cm4ean69r0003w8w1cdomox9n"], "type": "BUSINESS", "logo": "https://uploads.usenadia.com/2026/10/28/logo.png", "website": "https://maltaexpat.com", "country": "MT", "timezone": "Europe/Malta", "about": "Guides for expats moving to Malta. Friendly, practical tone." }]| Champ | Type | Description |
|---|---|---|
id |
string |
L’id du workspace, ce que prennent GET /integrations?workspace= et GET /posts?workspace= |
name |
string |
Tel qu’affiché dans l’application |
channels |
string[] |
Les ids des canaux du workspace |
type |
string |
PERSONAL, BUSINESS ou CLIENT |
logo |
string | null |
L’URL du logo ; null sans logo, ou quand son média a été supprimé de la bibliothèque |
website |
string | null |
Le site de la marque |
country |
string | null |
Le pays de l’audience, ISO 3166-1 alpha-2 (MT) |
timezone |
string | null |
Le fuseau du workspace, IANA (Europe/Malta) |
about |
string | null |
Marque, audience, ton : le contexte qu’un agent lit avant d’écrire pour ce workspace |
Un champ que personne n’a rempli vaut null. Créer, renommer ou supprimer un
workspace, remplir son contexte et y déplacer un canal se fait depuis
l’application (Paramètres → Workspaces).
Déconnecter un canal
Section intitulée « Déconnecter un canal »DELETE /integrations/{id}Supprime le canal et toutes les publications planifiées dessus. Réponse
200 : la ligne du canal. 404 quand il n’est pas le vôtre, ou
qu’il est déjà supprimé.