Nouveau · API Loop
Branchez Loop à tous vos outils.
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.
- 22 ressources
- Simulation avant écriture
- Événements signés
- Compatible Zapier, n8n et Make
- 09:12:44 inscriptions.creee → Zapier 200
- 09:12:41 affaires.modifiee → CRM 200
- 09:12:37 sessions.etat_modifie → n8n 200
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.
GET /global_api/v1/apprenants?q=dupontGET /global_api/v1/affaires?cursor=104701 - 03
Abonnez-vous aux événements
Indiquez une adresse et les événements qui vous intéressent : Loop l'appelle dès qu'une fiche est créée, modifiée, change d'état ou est supprimée.
POST /global_api/v1/webhooks{ "url": "https://…", "events": ["inscriptions.creee"] }
- 22ressources, de l'apprenant au catalogue
- 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 web POST /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.creee Zapier Slack -
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.modifiee CRM -
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.
- Apprenants /v1/apprenants
- Entreprises /v1/entreprises
- Contacts /v1/contacts
- Formateurs /v1/formateurs
- Programmes /v1/programmes
- Inscriptions apprenants /v1/inscriptions
- Inscriptions entreprises /v1/inscriptions-entreprises
- Interventions formateurs /v1/interventions
- Affaires /v1/affaires
- Lieux /v1/lieux
- Salles /v1/salles
- Tâches /v1/taches
- Sessions /v1/sessions
- Factures /v1/factures
- Échéances /v1/echeances
- Formulaires /v1/formulaires
- Réponses /v1/reponses
- Modèles de parcours /v1/modeles-parcours
- Résultats de quiz /v1/resultats-quiz
- Dépôts de quiz /v1/depots-quiz
- Landing pages /v1/landing-pages
- Catalogues /v1/catalogues
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
cursoretlimit: stable, même sur de gros volumes. - Recherche libre
qet filtres de dateupdated_since,created_since: la base de toute synchronisation régulière. ?champs_specifiques=1renvoie les champs spécifiques créés par votre organisme, avec leur libellé et leur section.?tous_les_champs=1ajoute 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.
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é.
-
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.
Les mêmes automatismes que 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
financementscomplet 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: truecrée le champ spécifique manquant, puis y écrit la valeur.- Aucun e-mail envoyé, aucun compte de connexion créé par l'API.
39 erreurs, rangées par famille
10xxAccès11xxRequête12xxChamps13xxLiens entre fiches14xxRègles métier15xxLimites19xxService
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.
/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.
<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.
Votre outil ne répond pas ? Loop réessaie.
Jusqu'à 8 réessais, de plus en plus espacés.- 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.
/v1/apprenants /v1/inscriptions 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}
/v1/sessions /v1/factures - 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.
La clé complète n'est affichée qu'une fois, à sa création : Loop n'en conserve qu'une empreinte.
200503503200200200-
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.
GET /global_api/v1/openapi.json
Questions fréquentes
L'API Loop en clair
À quoi sert l'API Loop ?
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.
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.
