Utiliser l'API de Scheduled : token, scopes, posts, médias et webhooks
Scheduled a une API REST, le mĂȘme moteur que celui qu'utilise Claude. Utilise-la pour brancher Scheduled Ă Zapier, n8n, Make ou tes propres scripts : programmer des posts, envoyer des mĂ©dias, lire tes stats et ĂȘtre prĂ©venu quand un post part.
Avant de commencer
- URL de base :
https://api.scheduled.so/v1 - Authentification : un Personal Access Token. CrĂ©e-en un dans ParamĂštres â API en ne donnant que les permissions dont ton outil a besoin. Envoie-le dans
Authorization: Bearer <token>. - Format : JSON en entrĂ©e et en sortie. Les erreurs ressemblent toujours Ă
{ "error": "...", "message": "...", "request_id": "..." }: garde lerequest_idsi tu nous Ă©cris. - Limites : 600 requĂȘtes par minute et par token.
Permissions (scopes)
read:calendars,read:connections: lister tes calendriers et comptes connectésread:posts: lister et lire des postswrite:posts: créer et modifier des posts, relancer un calendrier, vérifier des tags LinkedIndelete:posts: annuler des postsread:analytics: stats, meilleurs posts, comparaisons, meilleurs créneauxwrite:media: envoyer et lire des médias
Programme ton premier post
curl -X POST https://api.scheduled.so/v1/posts \
-H "Authorization: Bearer $TOKEN" \
-H "Idempotency-Key: lancement-2026-11-20" \
-H "Content-Type: application/json" \
-d '{
"scheduled_for": "2026-11-20T09:00:00+01:00",
"social_connection_labels": ["LI@ton-nom"],
"title": "Post de lancement (interne)",
"text": "On vient de le sortir."
}'
social_connection_labelssont les labels affichĂ©s dans l'app (ou utilisesocial_connection_ids). Avec un seul calendrier actif tu peux omettre le calendrier, sinon passecalendar_nameoucalendar_id.titleest interne (affichĂ© dans Notion). Le texte publiĂ© esttext.Idempotency-Keyrend l'appel sĂ»r Ă rejouer : la mĂȘme clĂ© renvoie le mĂȘme rĂ©sultat au lieu de crĂ©er un second post.- Un
201veut dire que la carte existe déjà dans Notion. Un202veut dire qu'elle est créée mais que la synchro rattrape encore : ne la renvoie pas, lis-la avecGET /v1/posts.
Ajouter des médias, une couverture et un titre de vidéo
POST /v1/mediaavecfilename,mime_typeetsize_bytes. Tu reçois une URL d'envoi.PUTle fichier vers cette URL.- Utilise l'identifiant
media_...reçu dansmedia_idsà la création du post.
Pour une vidĂ©o, ajoute une couverture (un JPEG ou PNG envoyĂ© de la mĂȘme façon) et un titre :
"media_ids": ["media_<video>"],
"cover_media_id": "media_<image>",
"video_title": "Pourquoi MQTT ?"
- La couverture n'est pas dans
media_ids: une vidéo plus une image là -dedans forme un post multi-médias, que YouTube refuse. video_titleest utilisé sur YouTube (100 caractÚres max) et LinkedIn.- La couverture demande la fonctionnalité Cover image sur la base Notion du calendrier, sinon tu reçois
cover_property_missinget rien n'est créé. - Tu peux changer ou retirer la couverture plus tard avec
PATCH /v1/posts/:idetcover_media_id(un identifiant de média, ounull). - Tu peux changer le titre de la vidéo plus tard avec
PATCH /v1/posts/:idetvideo_title(1 à 100 caractÚres, ounullpour l'effacer). Un post sans bloc vidéo est refusé avecvideo_not_foundet rien ne change. - Pour YouTube, choisis comment la vidéo est publiée avec
visibility:public,unlistedouprivate(public si tu l'omets). Il faut la fonctionnalité Visibilité YouTube sur la base Notion du calendrier, sinon tu reçoisvisibility_property_missinget rien n'est créé.PATCH /v1/posts/:idpeut la changer tant que le post n'est pas publié, ensuite il répondalready_published: passe par YouTube Studio. Les vidéos non répertoriées ou privées n'ont pas de statistiques dans Scheduled.
Vérifier un tag LinkedIn avant de poster
POST /v1/linkedin/mentions/check avec { "profile_urls": ["https://www.linkedin.com/in/jane-doe"] } (profils ou pages entreprise, 5 liens maximum). Chaque lien revient taggable (avec le nom), not_taggable ou unknown. C'est limité à 60 vérifications par heure. taggable veut dire que Scheduled sait construire le tag, LinkedIn peut encore refuser de l'afficher.
Vérifier un post avant de le créer
Tu n'es pas sĂ»r qu'un post va passer (un texte trop long pour X, un post sans mĂ©dia sur Instagram, un format de mĂ©dia) ? Envoie le mĂȘme corps avec "dry_run": true. Scheduled lance les mĂȘmes contrĂŽles que pour un vrai post et rĂ©pond sans rien crĂ©er dans Notion ni rien programmer :
{ "dry_run": true, "valid": false, "error": { "code": "x_limit_exceeded", "message": "..." } }valid: trueveut dire que le post serait acceptĂ© tel quel. Renvoie-le sansdry_runpour le crĂ©er. L'appel rĂ©pond200mĂȘme quand le post n'est pas valide (calendrier ou compte inconnu compris) : lisvalid.- Ăa ne vĂ©rifie pas ce qui n'existe qu'une fois la carte dans Notion (options de reel ou de story, propriĂ©tĂ©s
sc_*), ni ce qui peut échouer à la publication. La réponse le liste dansnot_checked. - Un dry run n'utilise jamais ton
Idempotency-Key, tu peux donc rĂ©utiliser la mĂȘme clĂ© pour l'appel rĂ©el. Il est limitĂ© Ă 20 par minute.
Les principaux endpoints
GET /posts,GET /posts/:id: lister (pagination par curseur) et lire des postsPOST /posts,PATCH /posts/:id: créer et modifier un postPOST /posts/:id/duplicate: copier un post vers une autre dateDELETE /posts/:id: annuler un postGET /calendars,GET /connections: tes calendriers et comptesGET /analytics/top-posts,/analytics/compare,/analytics/post/:id: statsGET /scheduling/best-times,/scheduling/next-slot: quand posterPOST /media,GET /media/:id: envoyer et vérifier des médias
Ătre prĂ©venu avec les webhooks
CrĂ©e un endpoint avec POST /v1/webhook_endpoints et tu reçois post.published, post.failed et post.sync_failed. Chaque appel est signĂ© : vĂ©rifie l'en-tĂȘte X-Scheduled-Signature (t=<unix>,v1=<hmac>) avec le secret affichĂ© Ă la crĂ©ation de l'endpoint, et utilise X-Scheduled-Delivery pour ignorer les doublons.
Ce que l'API ne sait pas faire (pour l'instant)
- Changer le texte ou les médias d'un post existant : annule-le et crées-en un nouveau.
Ă retenir
- Personal Access Token, avec scopes, rĂ©vocable, 600 requĂȘtes par minute.
- Chaque post atterrit dans ton calendrier Notion.
- Envoie un
Idempotency-Keyà la création pour qu'un nouvel essai ne duplique jamais un post. - La couverture d'une vidéo est un
cover_media_idĂ part, jamais dansmedia_ids. - Envoie
dry_run: truepour vérifier un post avant de le créer.
Mis Ă jour le : 18/11/2026
Merci !
