L'API Loop ouvre votre espace à Zapier, n8n, Make, à votre site, à votre CRM ou à votre outil de pilotage. Lisez et écrivez vos apprenants, sessions, inscriptions et affaires, et recevez un événement signé dès qu'une fiche change — que la modification vienne d'un outil branché ou de votre équipe dans Loop.
Illustration : trois requêtes types — lire, simuler une écriture, s'abonner — et les événements que Loop envoie aux outils branchés.
#inscriptionsMessagerie d'équipe
Aujourd'hui
Loop via n8n 09:12inscriptions.creeeNouvelle inscription : Julie M. · Excel avancé
Loop via n8n 10:41inscriptions.creeeNouvelle inscription : Karim B. · Management d'équipesaisie à la main dans Loop
Écrire dans #inscriptions
inscriptions.creeeévénement signé, livré?simulation=1rien n'est enregistré22 ressourceslecture et écriture
Le principe
Une clé, une requête, des événements
Trois notions suffisent pour tout brancher. Le reste — pagination, contrôles, réessais — Loop s'en occupe.
01
Créez une clé
Un administrateur la crée dans la fiche organisme et choisit ses portées, ressource par ressource : lecture, écriture, ou les deux. Elle n'est affichée qu'une fois.
Authorization: Bearer lfk_live_…
02
Envoyez une requête
Une adresse par ressource, du JSON à l'aller comme au retour. Recherche, filtres par date et pagination par curseur fonctionnent partout de la même façon.
39erreurs numérotées, chacune avec sa cause et son remède
≈ 0,26 spour parcourir 10 000 affaires
8réessais au maximum pour livrer un événement
Cas d'usage
Ce que l'on branche en premier
Six scénarios concrets, réalisables avec Zapier, n8n, Make ou quelques lignes de code.
Formulaire du site → affaire dans Loop
Chaque demande envoyée depuis votre site crée une affaire dans votre pipeline commercial, avec son contact. Plus de ressaisie, plus de demande oubliée dans une boîte mail.
site webPOST /v1/affaires
Nouvelle inscription → message d'équipe
Via Zapier ou n8n, votre équipe est prévenue dans Slack ou Teams dès qu'un apprenant est inscrit — y compris quand l'inscription est saisie à la main dans Loop.
inscriptions.creeeZapierSlack
Tableau de bord BI
Sessions, factures, échéances et affaires alimentent votre outil de pilotage page après page, avec les seules fiches modifiées depuis la dernière synchronisation.
GET /v1/factures?updated_since=…BI
Synchronisation d'un CRM externe
Contacts, entreprises et affaires restent alignés entre Loop et votre CRM : lecture, écriture et événements pour que chaque changement se propage.
affaires.modifieeCRM
Leads de landing page → outil marketing
Les contacts recueillis par vos landing pages Loop, et leurs statistiques, partent vers votre outil d'e-mailing ou de marketing automation.
GET /v1/landing-pages/{id}/leads
Quiz et progression e-learning → outil RH
Résultats de quiz et progression e-learning de chaque inscrit remontent dans le système RH de l'entreprise cliente ou dans vos bilans.
GET /v1/inscriptions/{id}/elearning
Ressources
22 ressources, les mêmes règles partout
Chaque ressource a son adresse, ses champs, ses filtres et ses droits. Ce que l'API peut modifier est exactement ce qu'il est sûr de modifier depuis l'extérieur.
Écriturecréer, modifier, supprimerModificationmodifier seulement
Modèles de parcours/v1/modeles-parcoursLecture seule
Résultats de quiz/v1/resultats-quizLecture seule
Dépôts de quiz/v1/depots-quizLecture seule
Landing pages/v1/landing-pagesLecture seule
Catalogues/v1/cataloguesLecture seule
Les sessions se modifient par l'API mais se créent dans Loop. Les factures restent en lecture : elles partent automatiquement en comptabilité. Voir la passerelle Pennylane →
Lire vos données
Pagination par curseur avec cursor et limit : stable, même sur de gros volumes.
Recherche libre q et filtres de date updated_since, created_since : la base de toute synchronisation régulière.
?champs_specifiques=1 renvoie les champs spécifiques créés par votre organisme, avec leur libellé et leur section.
?tous_les_champs=1 ajoute le reste de la fiche : réponses de formulaire, colonnes conservées lors d'un import.
Les mots de passe et les jetons de service ne sortent jamais, quel que soit le réglage.
≈ 0,26 spour paginer 10 000 affaires, du premier au dernier curseur.
Suivi et statistiques
GET/v1/sessions/{id}/elearningProgression e-learning d'une session
GET/v1/inscriptions/{id}/elearningProgression e-learning d'un inscrit
GET/v1/formulaires/{id}/statistiquesStatistiques d'un formulaire
GET/v1/landing-pages/{id}/leadsContacts recueillis par une landing page
GET/v1/landing-pages/{id}/statistiquesStatistiques d'une landing page
GET/v1/catalogues/{id}/formationsFormations publiées dans un catalogue
GET/v1/sessions?formation={id}Sessions d'une formation
GET/v1/filtres · /v1/statistiquesFiltres disponibles et indicateurs de l'organisme
Le catalogue public accepte aussi une clé API portant la portée catalogues:read.
Écrire sans risque
Écrire dans Loop, sans mauvaise surprise
Un outil qui écrit dans votre gestion de formation doit être plus prudent qu'un humain. L'API Loop l'est par construction.
?simulation=1
Simulation
Sur une création, une modification ou une suppression : toutes les règles sont vérifiées, la réponse montre ce qui serait écrit et ce que Loop ferait en plus. Rien n'est enregistré.
Idempotency-Key
Rejeu sans doublon
Un envoi rejoué dans les 24 heures — coupure réseau, relance automatique — renvoie la première réponse au lieu de créer une seconde fiche.
DELETE → corbeille
Suppression réversible
Une suppression place la fiche à la corbeille. Elle se récupère comme n'importe quelle fiche supprimée dans Loop.
LOOP-1xxx
Refus expliqués
Chaque refus donne un code stable, un message, la cause, le remède et le paramètre concerné.
Les mêmes automatismes que dans Loop
Une fiche écrite par l'API ressemble à une fiche créée dans Loop
Numérotation automatique appliquée, organisme et auteur renseignés : la fiche ressemble à une fiche créée dans Loop.
Inscrire un apprenant à une session inscrit aussi son entreprise si besoin — signalé dans actions_complementaires.
Bloc financements complet en lecture et en écriture : OPCO, CPF, France Travail, entreprise, financement personnel — montant, pourcentage, financeur, numéros de dossier et de contrat. Total contrôlé, jamais plus de 100 %.
Rémunération des formateurs sur leurs interventions : forfait, temps passé, frais.
creer_champs_manquants: true crée le champ spécifique manquant, puis y écrit la valeur.
Aucun e-mail envoyé, aucun compte de connexion créé par l'API.
HTTP/1.1409 Conflict{"error": {"code": "LOOP-1404","type": "business_rule","message": "Une fiche existe déjà avec cette adresse e-mail : 1207.","cause": "La déduplication par e-mail est active sur ce type de fiche.","remede": "Modifiez la fiche existante, ou envoyez « autoriser_doublon: true » si le doublon est voulu.","param": "email","doc": "https://votre-espace/global_api/v1/docs#erreurs" }}
codeUn code stable, lisible par programme : LOOP-1404 signifie toujours la même chose.
causePourquoi la requête est refusée, écrit pour un humain.
remedeCe qu'il faut faire — y compris l'option pour passer outre quand le doublon est voulu.
paramLe champ en cause, pour signaler la bonne case dans votre formulaire.
Un refus qui explique. Les 39 erreurs de l'API suivent la même forme : votre scénario sait quoi faire, votre équipe comprend pourquoi.
39 erreurs, rangées par famille
10xxAccès
11xxRequête
12xxChamps
13xxLiens entre fiches
14xxRègles métier
15xxLimites
19xxService
Quelques exemples
LOOP-1401Apprenant déjà inscrit à cette session.
LOOP-1405SIRET déjà pris — contournable par autoriser_doublon.
LOOP-1410Dates incohérentes : la fin précède le début.
LOOP-1412Somme des financements supérieure à 100 %.
LOOP-1301La fiche liée n'existe pas.
LOOP-1302La fiche liée appartient à un autre organisme.
LOOP-1303La fiche liée n'est pas du bon type.
L'API se décrit elle-même
/v1/erreursLe catalogue complet des erreurs, lisible par programme.
/v1/valeursLes valeurs autorisées, y compris les listes configurées par votre organisme.
/v1/schema/<ressource>Champs, champs spécifiques réels avec leur identifiant, obligatoires, règles en clair — et un exemple de création avec de vrais identifiants de votre organisme.
Événements · webhooks
Loop vous prévient dès qu'une fiche change
Abonnez n'importe quelle adresse aux événements de vos ressources avec POST /v1/webhooks. Chaque envoi transporte la fiche complète et une signature.
Cinq types d'événements
<ressource>.creeeUne fiche vient d'être créée.
<ressource>.modifieeUne information de la fiche a changé.
<ressource>.etat_modifieLa fiche a changé d'état ou d'étape.
<ressource>.supprimeeLa fiche a été supprimée.
<ressource>.lot_termineUn traitement en masse a touché plus de 200 fiches : un seul événement.
Les événements partent aussi quand votre équipe agit à la main dans Loop, pas seulement quand l'API écrit.
Import de plus de 200 fiches : un unique événement de fin de lot, pour ne pas saturer vos scénarios.
Aucun coût ni ralentissement tant qu'aucun abonnement n'existe.
Abonnements visibles dans Loop : filtres, pause et reprise, compteurs et historique des envois.
# À recalculer de votre côté, avec le secret de l'abonnementsignature = HMAC_SHA256( t + "." + corps_du_message , secret )# Identique à v1 : le message vient bien de Loop
Signature valide
Un événement signé. La fiche complète voyage avec l'événement, et la signature prouve qu'il vient de Loop.
Votre outil ne répond pas ? Loop réessaie.
Jusqu'à 8 réessais, de plus en plus espacés.
503503envoi200 · livré8e réessai
Chaque échec reporte l'envoi, sans rien perdre ni bloquer votre espace.
Livrés, en attente, abandonnés : chaque abonnement a ses compteurs et son historique.
Une pause arrête les envois ; une reprise ne rejoue pas d'un coup des événements périmés.
Documentation
Une documentation qui connaît votre espace
Métier et technique à la fois, à l'adresse /global_api/v1/docs de votre espace. Collez votre clé : les champs, les valeurs autorisées et les exemples deviennent les vôtres.
Votre clélfk_live_••••••••••••••••3f9aClé reconnue · vos champs et vos valeurs sont affichésopenapi.json
Sommaire
1À quoi ça sert2Ce qu'on peut en faire3Comment ça marche4Premier appel5Clés et permissions6Les 22 ressources7Suivi et statistiques8Lire des données9Vos champs spécifiques10Écrire dans Loop11Événements · webhooks12Zapier13n8n, Make et les autres14Recettes15Erreurs16Sécurité17Essayer maintenant
L'inscription d'un apprenant à une session, avec son état et ses financements.
GET/v1/inscriptions
GET/v1/inscriptions/{id}
POST/v1/inscriptions
PATCH/v1/inscriptions/{id}
DELETE/v1/inscriptions/{id}
Apprenantidentifiant · obligatoire
Sessionidentifiant · obligatoire
Étatvaleurs autorisées
Financementsbloc · total ≤ 100 %
Vos champs spécifiques3 champs de votre organisme
GETEssayerExempleTESTSimuler la création
POST/v1/inscriptions?simulation=1200
{"simulation": true,"operation": "creation","objet": "inscriptions","enregistre": false,"resultat": "Toutes les règles sont respectées : la requête réelle aboutirait.","actions_complementaires": ["Inscription de l'entreprise 88412 à la session 312 (créée automatiquement)." ]}
Sessions de formation/v1/sessionsLectureModification
Factures, devis et avoirs/v1/facturesLecture seule
La documentation, dans votre espace. Chaque ressource se déplie : adresses, champs, règles — et trois boutons pour lire pour de vrai, copier un exemple ou simuler une écriture.
17 sections, métier et technique
À quoi ça sert, cas d'usage, démarrage, clés, ressources, lecture, écriture, suivi, erreurs, événements, Zapier, n8n, recettes, sécurité, console.
Un sommaire qui vous suit
Le sommaire latéral suit le défilement : vous savez toujours où vous êtes dans la page.
Votre clé, vos données
Collez votre clé en haut de page : la documentation affiche vos champs spécifiques et vos valeurs autorisées.
Essayer
Une vraie lecture sur votre espace, depuis la page, sans outil à installer.
Exemple et Simuler
Un corps prêt à copier avec des valeurs fictives, ou une vraie requête envoyée en mode simulation.
OpenAPI et guide utilisateur
La spécification openapi.json se télécharge ; un chapitre API figure dans le guide utilisateur de Loop.
Clés et sécurité
Vos clés, vos règles, votre journal
L'écran « API Loop » de la fiche organisme, dans Intégrations puis Connecteurs, rassemble les clés et les abonnements. Il est réservé aux administrateurs.
96 livrés1 en attente0 abandonnésDernier envoi 09:10503
En attenteaffaires.etat_modifie · réessai 3 sur 8503
Livréaffaires.creee200
Livréaffaires.etat_modifie200
Tableur de suiviEn pausehttps://hook.eu1.make.com/••••
reponses.creee
57 livrés0 en attente3 abandonnésDernier envoi 11/09200
ReprendreSupprimer
Clés et abonnements, au même endroit. Portées visibles d'un coup d'œil, clé masquée, pause et reprise en un clic, et l'historique de chaque livraison.
Empreinte seulement
La clé complète s'affiche une fois. Loop n'en conserve qu'une empreinte : elle n'est plus lisible ensuite, par personne.
Portées par ressource
Lecture ou écriture, ressource par ressource, avec des jokers si besoin. Une clé ne fait que ce que vous avez autorisé.
Quota par minute
Au-delà, la réponse 429 demande d'attendre : un scénario qui s'emballe ne pénalise pas votre espace.
Adresses IP autorisées
Restreignez une clé aux serveurs de votre outil : utilisée ailleurs, elle est refusée.
Cloisonnement strict
Une clé ne voit que son organisme. Une fiche d'un autre organisme est refusée avec l'erreur LOOP-1302.
Journal des appels
Chaque appel est tracé : vous savez quel outil a fait quoi, et quand.
Connexion OAuth
Pour les applications : l'accès s'autorise en un clic, sans copier de clé.
Réservé aux administrateurs
Création, désactivation et suppression des clés et des abonnements restent entre leurs mains.
Connecteurs
Zapier, n8n, Make — ou votre propre code
L'API suit des conventions standard : les outils d'automatisation s'y branchent avec leurs briques habituelles.
Zapier
Abonnements aux événements compatibles Zapier (REST hooks) et connexion OAuth : un déclencheur « nouvelle inscription » se relie sans copier de clé.
inscriptions.creee → Slack, Teams, Sheets…
n8n
Un nœud Webhook abonné aux événements Loop, des nœuds HTTP Request avec votre clé pour lire et écrire. La documentation lui consacre un chapitre.
Authorization: Bearer lfk_live_…
Make
Un webhook personnalisé pour recevoir les événements, le module HTTP pour appeler les ressources. Les recettes de la documentation s'appliquent telles quelles.
POST /global_api/v1/webhooks
Votre code
Site, CRM, outil de BI ou développement maison : du JSON, une spécification OpenAPI à importer, des erreurs lisibles par programme.
Elle permet de piloter votre espace Loop depuis un autre outil : lire et écrire vos apprenants, entreprises, sessions, inscriptions, affaires ou tâches, et être prévenu quand une fiche change. C'est ce qui relie Loop à Zapier, n8n, Make, à votre site, à votre CRM ou à vos tableaux de bord.
Faut-il être développeur pour l'utiliser ?
Pas pour les usages courants : avec Zapier, n8n ou Make, vous assemblez des scénarios sans écrire de code, à partir de votre clé et des événements Loop. La documentation s'adresse aux deux publics, avec une partie métier (à quoi ça sert, cas d'usage, recettes) et une partie technique complète.
Où se trouve la documentation ?
Dans votre espace, à l'adresse /global_api/v1/docs. Collez votre clé dans la barre en haut de page : la documentation affiche alors vos propres champs spécifiques et vos valeurs autorisées, et chaque ressource peut être essayée. La spécification OpenAPI est téléchargeable, et un chapitre dédié figure dans le guide utilisateur de Loop.
Comment obtenir une clé ?
Un administrateur la crée dans la fiche organisme, rubrique Intégrations puis Connecteurs, et choisit ce qu'elle a le droit de faire, ressource par ressource. La clé n'est affichée qu'une fois : Loop n'en conserve qu'une empreinte. Pour les applications, une connexion OAuth évite même de copier une clé.
Peut-on tester une écriture sans rien modifier ?
Oui. Ajoutez ?simulation=1 à une création, une modification ou une suppression : Loop vérifie toutes les règles et renvoie ce qui serait écrit, avec les actions complémentaires qu'il déclencherait, sans rien enregistrer. Seule exception, signalée dans la réponse : la création de champs spécifiques manquants demandée avec creer_champs_manquants. Le bouton Simuler de la documentation fait la même chose.
Que se passe-t-il si une requête est envoyée deux fois ?
Avec l'en-tête Idempotency-Key, un envoi rejoué dans les 24 heures renvoie la première réponse au lieu de créer une seconde fiche. Et un apprenant déjà inscrit à une session ou une adresse e-mail déjà utilisée sont refusés avec une erreur explicite (LOOP-1401, LOOP-1404).
Les événements partent-ils aussi quand mon équipe travaille dans Loop ?
Oui. Une fiche créée, modifiée ou changée d'état à la main dans Loop déclenche les mêmes événements qu'une action faite par l'API. Lors d'un traitement de plus de 200 fiches, comme un import, un seul événement de fin de lot est envoyé.
Comment vérifier qu'un événement vient bien de Loop ?
Chaque envoi porte l'en-tête X-Loop-Signature, calculé en HMAC-SHA256 avec le secret remis à la création de l'abonnement. Si votre outil ne répond pas, Loop réessaie jusqu'à 8 fois à intervalles espacés, et l'historique de chaque abonnement montre ce qui a été livré, ce qui attend et ce qui a été abandonné.
Mes données sont-elles protégées ?
Chaque clé est cloisonnée à votre organisme, limitée à ses portées, soumise à un quota par minute et, si vous le souhaitez, à une liste d'adresses IP autorisées. Tous les appels sont journalisés, et les données sensibles comme les mots de passe ne sortent jamais. Les factures restent en lecture seule : elles partent automatiquement en comptabilité.
Est-ce compatible avec Zapier, n8n et Make ?
Oui. Les abonnements aux événements suivent le modèle REST hooks utilisé par Zapier, et une connexion OAuth permet de relier un compte sans copier de clé. n8n et Make se branchent avec leurs modules HTTP et webhook habituels, et la documentation propose des recettes prêtes à l'emploi.
GET/global_api/v1/docs
Branchez votre premier outil.
Créez votre espace, générez une clé, ouvrez la documentation : votre première requête part en quelques minutes, et un expert Loop peut vous accompagner sur vos scénarios.
Nous utilisons des cookies pour améliorer votre expérience, analyser le trafic et personnaliser le contenu.
Vous pouvez accepter tous les cookies, les refuser ou personnaliser vos choix.
Paramètres des cookies
🔒
Cookies essentiels
Nécessaires au fonctionnement du site. Ils ne peuvent pas être désactivés.
Toujours actif
Exemples : Session utilisateur, préférences de langue, sécurité CSRF
Durée : Session ou max 13 mois
📊
Cookies analytiques
Nous aident à comprendre comment vous utilisez le site pour l'améliorer.
Services : Google Analytics (anonymisé), statistiques internes
Durée : Max 13 mois
Données : Pages visitées, temps passé, source de trafic
📣
Cookies marketing
Permettent d'afficher des publicités pertinentes et de mesurer leur efficacité.
Services : Google Ads, Facebook Pixel, LinkedIn Insight