Ressources · Intégration n8n

Intégration Toggl n8nAutomatiser Toggl avec n8n.

Et si chaque chrono arrêté dans Toggl lançait le reste du travail tout seul ? L'intégration Toggl n8n repose sur un seul nœud, le Toggl Trigger : 1 événement, newTimeEntry, relevé à l'intervalle que tu choisis. Aucun nœud d'action côté Toggl, donc l'écriture passe par HTTP Request.

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

Qu'apporte vraiment l'intégration Toggl n8n ?

L'intégration Toggl n8n fonctionne dans un seul sens : n8n surveille ton compte Toggl et démarre un workflow, c'est-à-dire une suite d'étapes automatisées, dès qu'une nouvelle entrée de temps apparaît. Toggl reste l'endroit où les heures se saisissent. n8n devient l'endroit où ces heures deviennent une ligne de tableur, un message, un élément de facture. La connexion s'appuie sur un credential Basic auth, créé une fois et réutilisé partout.

Premier cas, une agence qui facture au temps passé. Chaque chrono arrêté va remplir une feuille de temps dans Google Sheets, sur l'onglet du client concerné. Plus personne ne recopie les heures en fin de mois, et le tableur sert directement de base à la facturation.

Deuxième cas, le suivi d'un budget qui part vite. L'entrée arrive, n8n la met en forme et envoie une alerte dans Telegram quand elle dépasse une durée que tu fixes avec un nœud de filtre. Le responsable de projet voit passer les blocs longs sans ouvrir un outil de reporting.

Troisième cas, la relation client. Un workflow accumule les entrées de la semaine et prépare un récapitulatif envoyé par Gmail, avec le détail de ce qui a été suivi. Le client reçoit toujours le même format, au même moment, sans que personne ne le rédige.

Ce que cette intégration ne fait pas : écrire dans Toggl. Le catalogue affiche 0 opération et 0 ressource pour cet outil. Autrement dit, aucun nœud n'écrit dans Toggl. Pour ça, il faut le nœud HTTP Request, qui appelle n'importe quel endpoint de l'API Toggl en réutilisant le même credential via l'authentification prédéfinie. C'est plus long à configurer qu'une liste déroulante, et c'est la seule route disponible ici.

L'autre limite tient au délai. Le trigger, le nœud qui déclenche le workflow, interroge l'API à intervalle régulier : l'entrée est vue au relevé suivant, pas à la seconde où le chrono s'arrête. Pour une feuille de temps ou un récap hebdo, ça ne change rien. Pour une réaction immédiate, ce n'est pas le bon outil. Si les notions de credential et d'exécution sont encore floues, la Formation n8n les pose avant de brancher quoi que ce soit en production.

Connexion

Comment connecter Toggl à n8n ?

  1. 01

    Créer le credential Toggl

    Il faut d'abord un compte Toggl. Dans n8n, ouvre le menu Credentials et crée un credential Toggl, c'est-à-dire l'identifiant stocké que n8n utilise pour parler à l'outil à ta place. Tu ne le crées qu'une fois : tous les workflows ajoutés ensuite le choisissent dans une liste déroulante. Avantage concret, le jour où le mot de passe change, la correction se fait à un seul endroit au lieu d'être cherchée workflow par workflow.

  2. 02

    Renseigner les deux champs Basic auth

    Toggl accepte une seule méthode d'authentification ici, la Basic auth, donc le formulaire tient en deux lignes. Username attend l'adresse email de ton compte utilisateur, celle de la connexion. Password attend le mot de passe de ce compte. Pas de clé à générer, pas de droit à cocher. En contrepartie, la connexion est liée à un vrai compte : pour une équipe, un compte d'exploitation partagé vaut souvent mieux qu'un compte personnel.

  3. 03

    Poser le trigger et choisir l'événement

    Ajoute le Toggl Trigger sur le canvas, sélectionne le credential, puis choisis l'Event que le nœud écoute. La version 1 du nœud propose newTimeEntry, et aucun autre paramètre n'attend de valeur. Règle l'intervalle de relevé, active le workflow, puis lance un chrono court dans Toggl : la première exécution te montre les données réellement reçues avant que tu construises la suite de la branche.

Déclencheurs

Qu'est-ce qui déclenche un workflow Toggl ?

Toggl Trigger est le nœud qui démarre un workflow quand quelque chose se passe dans Toggl. Il écoute 1 événements, listés ci-dessous par famille. Tu en choisis un ou plusieurs, tu actives le workflow : n8n enregistre le webhook (l'URL que Toggl appelle) sur ton compte.

Ce que tu vois dans n8n

Tous les événements, par famille

Une ligne par objet, une puce par action. L'événement à cocher dans le nœud s'écrit objet.action ; survole une puce pour lire quand il se déclenche.

new.*1

    Notes de configuration

    01Set Up the Toggl TriggerLe nœud Toggl Trigger démarre un workflow quand Toggl signale un événement. Sa configuration tient en trois décisions : le credential, l'événement écouté, la fréquence des relevés.

    Le nœud Toggl Trigger démarre un workflow quand Toggl signale un événement. Sa configuration tient en trois décisions : le credential, l'événement écouté, la fréquence des relevés.

    Paramètres clés

    • Event : l'événement Toggl écouté par le nœud. La version 1 n'expose qu'une valeur, newTimeEntry, réunie dans 1 famille. Rien à comparer dans la liste, et pas d'option fourre-tout qui attraperait tous les types d'événements d'un coup.
    • Poll Times : la fréquence à laquelle n8n demande à l'API Toggl si du nouveau est arrivé. C'est le polling : on interroge à intervalle régulier au lieu d'être prévenu. Une fois par minute au plus court ; un intervalle plus large suffit largement quand la sortie est un tableur consulté chaque matin.
    Quand l'utiliser
    quand le point de départ est une personne qui arrête un chrono, pas une heure de la journée. Pour un récapitulatif à heure fixe, c'est le Schedule Trigger qui ouvre le workflow.
    02New Time EntryChaque exécution transporte une seule entrée de temps fraîche. Le workflow traite donc un bloc de travail à la fois, jamais un lot à parcourir en boucle, ce qui simplifie franchement la branche qui suit.

    Chaque exécution transporte une seule entrée de temps fraîche. Le workflow traite donc un bloc de travail à la fois, jamais un lot à parcourir en boucle, ce qui simplifie franchement la branche qui suit.

    Paramètres clés

    • Event : positionné sur newTimeEntry, seule valeur de la famille new pour ce nœud. Aucun autre événement n'existe pour le combiner, donc plusieurs besoins Toggl se traduisent par plusieurs workflows distincts plutôt que par un nœud multi-cases.
    Cas d'usage
    un cabinet de conseil suit ses heures par mission et veut chaque entrée ajoutée à un tableau de suivi dès qu'elle existe. Un studio surveille la consommation d'un forfait projet et déclenche une alerte au-delà d'un seuil. Dans les deux cas, la suite du workflow lit l'item entrant avec une expression du type {{ $json.description }}, qui pointe un champ de l'élément émis par le trigger.
    Besoin d'aide

    Besoin d'aide pour automatiser Toggl avec n8n ?

    L'équipe te répond directement.

    Chaque message est lu par une personne.

    FAQ

    Toggl et n8n, les questions qui suivent

    01L'intégration Toggl n8n est-elle gratuite ?
    Oui du côté n8n. Le Toggl Trigger est livré avec n8n : rien à installer, rien à acheter, aucun passage par une place de marché. Le comportement est identique sur n8n Cloud, l'offre hébergée par n8n, et sur une instance auto-hébergée installée en Docker ou en npm, sous la Community Edition et sa licence Sustainable Use. Un workflow construit d'un côté tourne pareil de l'autre, ce qui laisse la liberté de commencer sur le Cloud puis de rapatrier plus tard. Ce que coûte un abonnement Toggl est une autre question, que cette page ne traite pas puisque le catalogue des nœuds ne donne pas cette information.
    02Quels identifiants faut-il pour le Toggl Trigger ?
    La Basic auth, et c'est la seule méthode supportée. Tu crées un credential Toggl dans le menu Credentials avec deux champs : Username, qui reçoit l'adresse email de ton compte utilisateur, et Password, qui reçoit le mot de passe de ce compte. Aucune clé d'API à générer, aucun écran OAuth, aucune liste de droits à valider. Comme le credential correspond à un accès complet au compte et non à un jeton limité, beaucoup d'équipes le rattachent à un compte d'exploitation partagé plutôt qu'au compte d'une personne. Une fois enregistré, il se sélectionne dans une liste pour tous les workflows suivants.
    03Quelles sont les limites du nœud Toggl dans n8n ?
    La première tient au périmètre. Le catalogue affiche 0 opération et 0 ressource pour Toggl : il n'existe aucun nœud d'action. n8n sait réagir à Toggl, jamais écrire dedans par un nœud dédié. Créer, corriger ou récupérer quoi que ce soit dans Toggl passe donc par le nœud HTTP Request, qui appelle n'importe quel endpoint de l'API Toggl en réutilisant le même credential via l'authentification prédéfinie. Côté trigger, 1 seul événement existe, newTimeEntry, sans option pour écouter tous les types d'événements. La version 1 du nœud n'expose aucun paramètre en dehors de l'événement.
    04Le Toggl Trigger réagit-il en temps réel ?
    Non, et autant être précis. Le nœud fonctionne par polling : n8n interroge l'API Toggl à l'intervalle fixé dans Poll Times pour savoir si de nouvelles entrées existent, puis émet un item par élément trouvé. Rien n'est enregistré côté Toggl, donc aucun webhook à configurer et aucune URL à exposer, ce qui simplifie beaucoup la mise en place. La contrepartie, c'est un délai égal à l'intervalle choisi, le plus court étant d'une fois par minute. Pour une feuille de temps, une alerte projet ou un récapitulatif client, ce délai ne se voit pas. Pour une réaction à la seconde, ce mécanisme ne convient pas.
    05n8n ou Make pour Toggl ?
    Ça dépend de tes priorités. Make est une plateforme hébergée, sans auto-hébergement possible, facturée à l'opération : un trigger qui interroge souvent consomme du quota même quand rien n'arrive. n8n s'auto-héberge sur ton serveur, ce qui garde les heures suivies et les identifiants du compte sur une infrastructure que tu maîtrises, et existe aussi en offre hébergée si personne chez toi ne veut administrer une instance. Sur cet outil précis, les deux plateformes partent du même socle maigre : 1 événement, aucune opération d'écriture. Le choix se joue donc sur l'hébergement, la maîtrise des données et le modèle de coût, pas sur le nœud Toggl.