Ressources · Intégration n8n

Intégration PagerDuty n8nAutomatiser PagerDuty avec n8n.

Une alerte qui réveille quelqu'un devrait déjà contenir son contexte. L'intégration PagerDuty n8n met 9 opérations et 4 ressources dans un workflow, cette suite d'étapes automatisées : incidents, notes, entrées de log et utilisateurs. PagerDuty n'a pas de nœud trigger dans n8n, le workflow démarre donc ailleurs.

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

Pourquoi automatiser

Que couvre l'intégration PagerDuty n8n, concrètement ?

Le nœud PagerDuty est livré avec n8n et parle à l'API REST de PagerDuty à ta place. Il expose 9 opérations réparties sur 4 ressources : Incident, Incident Note, Log Entry et User. Un workflow peut donc ouvrir un incident, le relire, lister les incidents d'une période, changer leur statut, y coller des notes, récupérer des entrées de log et retrouver un utilisateur, avec un seul credential créé une fois pour toutes.

Autant le dire tout de suite : il n'existe pas de nœud trigger PagerDuty dans n8n. Rien du côté PagerDuty ne lance un workflow tout seul. Le point de départ est ailleurs : un Schedule Trigger qui s'exécute à intervalle fixe, un nœud Webhook n8n (une URL que n8n expose pour qu'un service extérieur l'appelle), ou le trigger d'un autre outil. PagerDuty arrive ensuite, en action.

Trois usages reviennent tout le temps. Le premier : transformer un contrôle maison en astreinte. Un workflow planifié interroge une API ou une base, détecte l'anomalie, et appelle incident.create sur le bon service. Le deuxième : enrichir avant d'alerter. L'incident existe, le workflow le relit, va chercher les dernières entrées de log, résout la personne assignée avec user.get et envoie un récapitulatif sur Slack ou Telegram. Le troisième : le reporting, avec incident.getAll sur une plage de dates, déversé dans Google Sheets pour la revue d'astreinte.

Refermer la boucle compte autant que l'ouvrir. Quand la supervision annonce que le service est revenu à la normale, incident.update passe le statut à resolved et écrit dans Resolution ce qui s'est réellement passé. L'incident porte sa propre conclusion, personne n'a besoin de fouiller un fil de discussion trois semaines plus tard.

Là où le nœud s'arrête, HTTP Request prend le relais. N'importe quel endpoint de l'API REST de PagerDuty reste joignable avec le nœud HTTP Request, qui réutilise le même credential PagerDuty via l'authentification prédéfinie. Deux comportements à garder en tête avant de construire : une liste ne ramène tout que si Return All est activé, sinon n8n s'arrête à Limit ; et une recherche entre Since et Until couvre 6 mois au maximum.

Si l'astreinte est la première automatisation que l'équipe met en place, l'Avis n8n dit ce que la plateforme fait bien, et la Formation n8n reprend la construction de ce type de workflow pas à pas.

Connexion

Comment connecter PagerDuty à n8n ?

  1. 01

    Créer le credential dans n8n

    Dans n8n, ouvre le menu Credentials et ajoute un credential PagerDuty. Un credential, ce sont des identifiants stockés une fois : tous tes workflows le retrouvent ensuite dans la liste déroulante du nœud. Le nœud accepte deux méthodes d'authentification, jeton API et OAuth2. Le jeton va au plus vite pour un workflow qui tourne sans personne devant.

  2. 02

    Générer un jeton API dans PagerDuty

    Pour la méthode par jeton, il te faut un API Token d'accès général. Dans PagerDuty, va dans Integrations, puis Developer Tools, puis API Access Keys, puis Create New API Key. Copie la clé affichée et colle-la dans le champ API Token du credential n8n. C'est cette clé que le nœud envoie à chaque appel de l'API REST.

  3. 03

    Ou déclarer une app pour OAuth2

    Pour OAuth2, enregistre une nouvelle app PagerDuty. Dans la liste Category, choisis Infrastructure Automation, et dans la section Functionality, coche OAuth 2.0. Enregistre, puis édite la configuration de l'app : dans la section OAuth 2.0, clique Add, copie l'OAuth Callback URL affichée par n8n dans le champ Redirect URL, rapatrie le Client ID et le Client Secret dans n8n, et choisis Read/Write dans Set Permission Scopes.

Actions

Ce que le nœud PagerDuty sait faire

Le nœud PagerDuty expose 9 opérations sur 4 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.

Matrice ressources × opérations
RessourceCreateGetGet ManyUpdate
Incident✓✓✓✓
Incident Note✓✓
Log Entry✓✓
User✓

Incident

4 opérations
01

Create an incident

incident.create

Ce que tu vois dans n8n

Notes & cas d'usage

Ouvre un incident dans PagerDuty à partir de ce que le workflow vient de détecter, et renvoie l'incident créé.

Paramètres clés

  • Title : une description courte des symptômes ou de la cause, construite depuis l'alerte avec {{ $json.message }}.
  • Service Name or ID : le service sur lequel l'incident est créé, pris dans la liste ou défini par expression.
  • Email : un utilisateur valide du compte qui fait la requête, au format name@email.com.
  • Incident Key : dans Additional Fields, la clé de déduplication. Une requête sur le même service avec la même clé est rejetée tant qu'un incident correspondant reste ouvert.
Cas d'usage
le contrôle de sauvegarde échoue la nuit, le workflow ouvre un seul incident et la clé absorbe les tentatives suivantes.
02

Get an incident

incident.get

Ce que tu vois dans n8n

Notes & cas d'usage

Récupère un incident précis. C'est la manière propre de vérifier où en est une alerte avant d'agir dessus.

Paramètres clés

  • Incident ID : l'identifiant unique de l'incident, pas son titre. Il arrive en général d'un nœud précédent sous la forme {{ $json.id }}.
Cas d'usage
un workflow de relance relit l'incident un quart d'heure après son ouverture et n'envoie le rappel que si le statut n'a pas bougé.
03

Get many incidents

incident.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Liste les incidents du compte, avec une collection Options de 12 filtres pour ne garder que ce qui intéresse le rapport.

Paramètres clés

  • Return All : activé, n8n enchaîne les pages de l'API et ramène tous les incidents correspondants ; désactivé, Limit fixe le nombre maximal.
  • Statuses : ne garde que les incidents triggered, acknowledged ou resolved.
  • Since et Until : le début et la fin de la plage cherchée, limitée à 6 mois.
  • Include : ajoute des détails comme les personnes assignées ou les services.
Cas d'usage
l'export du lundi matin des incidents déclenchés la semaine passée, trié via Sort By.
04

Update an incident

incident.update

Ce que tu vois dans n8n

Notes & cas d'usage

Modifie un incident existant. Statut, titre, urgence, priorité et escalade tiennent dans une collection Update Fields de 7 entrées.

Paramètres clés

  • Incident ID : l'incident concerné par la modification.
  • Email : l'adresse d'un utilisateur valide du compte, obligatoire ici aussi.
  • Status : acknowledged ou resolved.
  • Resolution : le texte de résolution, qui n'a de sens que si le statut passe à resolved.
  • Escalation Level : fait monter l'incident à ce niveau de sa politique d'escalade.
Cas d'usage
la supervision voit le service repartir, le workflow résout l'incident et range la cause dans Resolution.

Incident Note

2 opérations
05

Create an incident note

incidentNote.create

Ce que tu vois dans n8n

Notes & cas d'usage

Colle une note sur un incident. C'est comme ça qu'une automatisation laisse du contexte à la personne qui décroche à trois heures du matin.

Paramètres clés

  • Incident ID : l'incident auquel la note est rattachée.
  • Content : le texte de la note, là où le workflow dépose les lignes de log fautives ou le lien vers la procédure.
  • Email : encore un utilisateur valide du compte qui fait la requête.
Cas d'usage
quelques secondes après l'ouverture, un second nœud publie les dernières erreurs en note. La personne d'astreinte démarre avec les preuves, pas avec une recherche.
06

Get many incident notes

incidentNote.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Relit en une fois les notes déjà déposées sur un incident, au lieu d'aller les chercher une par une.

Paramètres clés

  • Incident ID : les notes appartiennent à un seul incident, ce champ est donc requis.
  • Return All : toutes les notes de l'incident ; décoché, Limit décide combien reviennent.
Cas d'usage
une fois l'incident clos, le workflow de post-mortem rassemble ses notes et les publie en un seul message sur Discord.

Log Entry

2 opérations
07

Get a log entry

logEntry.get

Ce que tu vois dans n8n

Notes & cas d'usage

Va chercher une entrée de log précise. Une entrée de log, c'est la trace PagerDuty d'un événement unique sur un incident : un déclenchement, une prise en charge, une notification envoyée.

Paramètres clés

  • Log Entry ID : l'identifiant unique de l'entrée, repris d'une liste précédente sous la forme {{ $json.id }}.
Cas d'usage
un workflow d'audit isole l'entrée qui a acquitté un incident, pour consigner qui l'a fait et à quel moment.
08

Get many log entries

logEntry.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie les entrées de log du compte sur une période. C'est le plus proche d'un journal d'activité que le nœud expose, avec une collection Options de 5 filtres.

Paramètres clés

  • Return All : toutes les entrées page après page, ou Limit pour un échantillon.
  • Is Overview : activé, seuls les changements les plus importants de l'incident reviennent, ce qui garde une chronologie lisible.
  • Since et Until : la fenêtre de recherche, là aussi plafonnée à 6 mois.
  • Timezone Name or ID : sans ce champ, les dates reviennent en UTC.
Cas d'usage
la revue hebdo récupère les entrées d'aperçu et les transforme en chronologie.

User

1 opération
09

Get a user

user.get

Ce que tu vois dans n8n

Notes & cas d'usage

Retrouve un utilisateur du compte PagerDuty et renvoie sa fiche, pour mettre un nom derrière un identifiant.

Paramètres clés

  • User ID : l'identifiant unique de l'utilisateur, lu depuis un incident plutôt que saisi à la main. Le nœud renvoie la fiche complète de la personne.
Cas d'usage
après lecture d'un incident, le workflow convertit la personne assignée en nom et en adresse, puis envoie le message de passation avec Gmail.
Besoin d'aide

Besoin d'aide pour automatiser PagerDuty avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

PagerDuty et n8n, les questions qui reviennent

01L'intégration PagerDuty n8n est-elle gratuite ?
Oui, côté n8n. Le nœud PagerDuty est livré avec n8n : rien à installer, aucun coût supplémentaire pour le nœud lui-même, que tu sois sur n8n Cloud, l'offre hébergée par n8n, ou sur une instance auto-hébergée en Community Edition sous licence Sustainable Use. Un workflow se comporte de la même façon dans les deux cas, donc tu peux prototyper sur Cloud et rapatrier le même workflow sur ton Docker ensuite. Ce que coûte un abonnement PagerDuty est une autre question, que cette page ne traite pas.
02Quels credentials faut-il pour le nœud PagerDuty ?
Deux méthodes d'authentification sont acceptées : jeton API et OAuth2. Pour le jeton, génère un API Token d'accès général dans PagerDuty via Integrations, puis Developer Tools, puis API Access Keys, puis Create New API Key, et colle-le dans le credential n8n. Pour OAuth2, enregistre une app PagerDuty avec Category réglée sur Infrastructure Automation et OAuth 2.0 coché dans Functionality, copie l'OAuth Callback URL de n8n dans le champ Redirect URL de l'app, rapatrie le Client ID et le Client Secret dans n8n, et sélectionne Read/Write dans Set Permission Scopes. Le credential se crée une fois et sert dans tous les workflows.
03Quelles sont les limites du nœud PagerDuty ?
Le nœud expose 9 opérations sur 4 ressources : Incident, Incident Note, Log Entry et User. Pour tout le reste de l'API REST de PagerDuty, le nœud HTTP Request appelle n'importe quel endpoint en réutilisant le même credential PagerDuty via l'authentification prédéfinie. Tu n'es donc bloqué nulle part, et tu ne gères pas deux jeux de clés. Deux comportements se préparent à l'avance : une liste ne ramène l'ensemble que si Return All est activé, sinon Limit plafonne le résultat ; et une recherche entre Since et Until couvre 6 mois au maximum, donc un rapport plus long se construit en plusieurs passages.
04PagerDuty peut-il déclencher un workflow n8n en temps réel ?
Non. PagerDuty n'a pas de nœud trigger dans n8n, donc rien côté PagerDuty ne démarre un workflow tout seul. Trois contournements existent. Le Schedule Trigger lance le workflow à intervalle fixe et interroge PagerDuty avec une opération comme incident.getAll, ce qui suffit pour du reporting et des vérifications de suivi. Le nœud Webhook de n8n fournit une URL qu'un service tiers peut appeler, et c'est lui qui pousse alors l'information. Dernière option : le workflow démarre sur le trigger d'un autre outil, et PagerDuty devient l'action en bout de chaîne.
05n8n ou Make pour PagerDuty ?
Ça dépend de quatre critères, et aucun des deux outils n'est mauvais. L'hébergement d'abord : n8n s'installe sur ton propre serveur en Docker ou via npm, ou s'utilise sur n8n Cloud, quand Make existe uniquement en hébergé. La maîtrise des données en découle, puisqu'une instance auto-hébergée garde les contenus d'incidents et les adresses des utilisateurs chez toi. Le modèle de coût ensuite : Make se facture à l'opération, ce qui pèse dès qu'un workflow liste beaucoup d'incidents ou d'entrées de log. La logique visuelle enfin : les deux se construisent à la souris, le vrai test est de refaire un workflow d'astreinte dans chacun.