API publique
Créer une clé API kbs_, appeler l'API REST de Klickbee Social pour lister vos comptes, créer, planifier et publier des posts, et gérer les erreurs.
L'API REST permet de créer et planifier des posts depuis vos scripts, Zapier, Make, n8n ou tout autre outil. Les assistants IA peuvent aussi utiliser le serveur MCP.
Créer une clé API
Les clés se gèrent dans Réglages › API & MCP (rubrique Développeurs), réservé aux Super admins.
Cliquez sur Créer une clé et donnez-lui un Nom (par exemple « Zapier » ou « script interne »).
Copiez la clé affichée. Elle commence par kbs_ et ne sera plus jamais
affichée : seule une empreinte est conservée. Gardez-la secrète, comme un mot de
passe.
Une clé donne accès à toutes les marques de l'espace : lecture, création, planification et publication de posts. Vous pouvez avoir jusqu'à 20 clés actives. La liste indique pour chacune sa date de création et de dernière utilisation.
Révoquer coupe immédiatement et définitivement l'accès des scripts et assistants qui utilisent la clé. En cas de perte, révoquez-la et créez-en une autre.
S'authentifier
GET https://social.klickbee.com/api/v1/brands
Authorization: Bearer kbs_votre_cleLa documentation complète au format OpenAPI 3.1 est publique :
https://social.klickbee.com/api/v1/openapi.json.
Importez-la dans Postman, Insomnia ou votre générateur de client.
Les endpoints
| Méthode | Chemin | Rôle |
|---|---|---|
GET | /api/v1/brands | Lister les marques. |
GET | /api/v1/accounts?brandId= | Lister les comptes connectés d'une marque (réseau, nom, statut, créneaux…). |
GET | /api/v1/accounts/{id}/next-slot | Prochain créneau libre de la file d'un compte (null si les 60 prochains jours sont pleins). |
GET | /api/v1/posts | Lister les posts (filtres brandId, status, from, to, pagination limit / offset). |
POST | /api/v1/posts | Créer des posts : brouillon, planifiés, en file ou publiés tout de suite. |
GET | /api/v1/posts/{id} | Lire un post (statut, lien, erreur…). |
DELETE | /api/v1/posts/{id} | Supprimer un post non publié. |
POST | /api/v1/posts/{id}/schedule | Planifier ou déplacer un post. |
POST | /api/v1/posts/{id}/retry | Relancer un post en échec. |
DELETE | /api/v1/posts/{id}/publication | Retirer un post publié de son réseau (mêmes réseaux que dans l'app). |
POST | /api/v1/media | Importer un média depuis une URL dans la médiathèque. |
Créer un post
curl -X POST https://social.klickbee.com/api/v1/posts \
-H "Authorization: Bearer kbs_votre_cle" \
-H "Content-Type: application/json" \
-d '{
"brandId": "…",
"posts": [
{ "platform": "LINKEDIN", "body": "Notre nouveau guide est en ligne." },
{ "platform": "THREADS", "body": "Nouveau guide en ligne 👇" }
],
"schedule": { "queue": true },
"idempotencyKey": "guide-2026-10"
}'posts: 1 à 20 posts, un par compte. Réseaux :LINKEDIN,THREADS,INSTAGRAM,FACEBOOK,TIKTOK,YOUTUBE. PrécisezsocialAccountIdsi la marque a plusieurs comptes sur un réseau.schedule: absent = brouillon ;{ "at": "2026-11-02T09:00:00+01:00" }= date précise ;{ "queue": true }= prochain créneau libre ;{ "now": true }= publication immédiate.media: jusqu'à 10 médias par post, chacun avec uneurlpublique et sonmime(PNG, JPEG, WebP, GIF, PDF, MP4, MOV). Les médias sont téléchargés et ajoutés à la médiathèque (images et PDF jusqu'à 15 Mo, vidéos jusqu'à 100 Mo).firstComment: le premier commentaire.- TikTok exige
settings.privacyLevelpour planifier ou publier. idempotencyKey: renvoyer la même requête avec la même clé ne crée pas de doublon.
Limites et erreurs
L'API accepte 120 requêtes par minute et par clé. Au-delà, elle répond 429
avec un en-tête Retry-After.
Les erreurs ont la forme { "error": { "code": "…", "message": "…" } } :
| Code | HTTP | Cause |
|---|---|---|
unauthorized | 401 | Clé absente, inconnue ou révoquée. |
forbidden | 403 / 402 | Action non autorisée, ou espace en lecture seule (402). |
not_found | 404 | Marque, compte ou post introuvable. |
validation_error | 400 | Requête invalide (le message précise le champ). |
conflict | 409 | Par exemple, supprimer un post publié ou en cours de publication. |
media_error | 422 | Média impossible à télécharger ou format refusé. |
rate_limited | 429 | Trop de requêtes. |
Flux RSS
Transformer automatiquement chaque nouvel article d'un blog ou d'une veille en posts, en brouillon ou dans la file d'attente, avec ou sans réécriture par l'IA.
Webhooks
Recevoir les événements de publication et de l'Inbox sur votre serveur, Zapier, Make ou n8n, et vérifier leur signature HMAC.