Ressources · Intégration n8n

Intégration BambooHR n8nAutomatiser BambooHR avec n8n.

Une fiche salarié finit toujours par être recopiée ailleurs. L'intégration BambooHR n8n couvre 15 opérations réparties sur 4 ressources : salariés, documents de salarié, fichiers d'entreprise et rapports enregistrés. Aucun trigger côté BambooHR : le workflow démarre ailleurs. Pour les équipes RH et ops.

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

Pourquoi automatiser

Que fait vraiment l'intégration BambooHR n8n ?

Le nœud BambooHR appelle l'API de BambooHR depuis un workflow n8n. Il crée et met à jour des fiches salariés, lit une fiche précise ou la liste complète, dépose et récupère les documents rattachés à une personne, gère les fichiers partagés de l'entreprise, et sort n'importe quel rapport enregistré au format CSV, JSON, PDF, XLS ou XML. Un seul credential par clé API suffit pour les 15 opérations, et le nœud est livré avec n8n : rien à installer.

Premier cas : l'arrivée d'un salarié. La promesse d'embauche est signée, la ligne existe déjà dans un tableur de suivi, et quelqu'un la retape dans l'outil RH. Avec employee.create, cette étape saute. Un nœud Google Sheets lit la ligne, le nœud BambooHR remplit nom, prénom, date d'embauche et département, et la fiche existe avant même la commande du matériel.

Deuxième cas : les documents que personne ne relance. Une attestation signée arrive en pièce jointe dans Gmail, le workflow passe le fichier binaire à employeeDocument.upload, et le document atterrit dans la bonne catégorie sous la bonne personne, partagé avec elle ou gardé côté RH. Le même run poste une ligne dans Slack quand le dossier est complet.

Troisième cas : le rapport réclamé tous les mois. companyReport.get exécute un rapport déjà enregistré dans BambooHR et le renvoie sous forme de fichier, dans le champ de sortie que tu choisis. Le PDF part à un manager, ou la version JSON passe dans les nœuds suivants pour être filtrée avant que quoi que ce soit ne sorte de n8n.

Quand une opération manque à la liste des 15, le nœud HTTP Request appelle n'importe quel autre endpoint de l'API BambooHR en réutilisant le même credential via l'authentification prédéfinie. Tu restes sur un seul jeu de clés au lieu de deux.

Deux détails changent la façon de construire. D'abord, il n'existe pas de trigger BambooHR : le workflow démarre avec un Schedule Trigger à intervalle fixe, un nœud Webhook n8n appelé par un service tiers, ou le trigger d'un autre outil. Ensuite, les opérations de liste ne parcourent toutes les pages de l'API que si Return All est activé ; sinon Limit plafonne le nombre d'items. Deux lectures utiles avant de te lancer : l'Avis n8n sur le comportement réel de la plateforme, et la Formation n8n si les expressions restent floues.

Connexion

Comment connecter BambooHR à n8n ?

  1. 01

    Générer une clé API dans BambooHR

    Une seule méthode d'authentification est supportée : la clé API. La procédure de génération se trouve dans la section authentification de la documentation « getting started » de l'API BambooHR. Point important : la clé hérite des droits du compte qui la crée. Génère-la donc depuis un compte qui voit déjà les salariés, les documents et les rapports que le workflow devra manipuler.

  2. 02

    Récupérer le sous-domaine

    Le credential demande aussi un Subdomain, c'est-à-dire la portion comprise entre https:// et .bamboohr.com dans l'adresse utilisée tous les jours. Si l'équipe se connecte sur https://acme.bamboohr.com, le sous-domaine vaut acme, rien de plus. Coller l'URL complète dans ce champ reste le meilleur moyen de rater sa première exécution.

  3. 03

    Enregistrer le credential dans n8n

    Dans n8n, ouvre le menu Credentials et crée un credential BambooHR, c'est-à-dire le jeu de clés stocké qu'un nœud utilise pour signer ses appels. Colle le sous-domaine et la clé API, enregistre, et chaque nœud BambooHR le propose ensuite dans sa liste déroulante. Un credential couvre les 4 ressources : un deuxième workflow ne demande aucune nouvelle clé.

Actions

Les 15 opérations BambooHR dans n8n

Le nœud BambooHR expose 15 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 ManyUpdateDeleteDownloadUpload
Company Report✓
Employee✓✓✓✓
Employee Document✓✓✓✓✓
File✓✓✓✓✓

Company Report

1 opération
01

Get a company report

companyReport.get

Ce que tu vois dans n8n

Notes & cas d'usage

Exécute un rapport déjà enregistré dans BambooHR et le renvoie au workflow sous forme de fichier.

Paramètres clés

  • Report ID : le numéro du rapport. Il apparaît au survol du nom du rapport, sur la page des rapports de BambooHR.
  • Format : CSV, JSON, PDF, XLS ou XML. Le JSON reste exploitable par les nœuds suivants, le PDF convient à un rapport qu'on se contente d'ouvrir.
  • Put Output In Field : le nom du champ de sortie qui portera le fichier binaire.
  • Only Current (Options) : masque les valeurs datées dans le futur des champs de type historique.
Cas d'usage
envoyer le rapport d'effectif chaque lundi, ou comparer la version JSON au mois précédent.

Employee

4 opérations
02

Create an employee

employee.create

Ce que tu vois dans n8n

Notes & cas d'usage

Crée une fiche salarié. La liste de champs obligatoires est longue : le nœud attend un dossier complet.

Paramètres clés

  • First Name et Last Name : le bloc identité, alimenté depuis le nœud précédent.
  • Hire Date et Date of Birth : des valeurs de type date, pas du texte libre.
  • Social Security Number : un numéro de sécurité sociale américain, avec les tirets (123-45-6789), format figé hors des États-Unis.
  • Department Name or ID, Division Name or ID, Location Name or ID : dans la liste, ou par expression.
  • Synced with Trax Payroll : si le calendrier de paie est synchronisé avec Trax Payroll.
Cas d'usage
transformer une ligne de recrutement validée en fiche réelle.
03

Get an employee

employee.get

Ce que tu vois dans n8n

Notes & cas d'usage

Lit une fiche salarié. Ses champs repartent dans le workflow, prêts à alimenter la suite du run.

Paramètres clés

  • Employee ID : l'identifiant BambooHR de la personne, jamais son nom, en général repris d'un nœud précédent sous la forme {{ $json.id }}.
  • Field Names or IDs (Options) : l'ensemble des champs à récupérer. À cocher dans la liste ou à passer par expression. Demander trois champs plutôt que le dossier entier garde une charge utile lisible.
Cas d'usage
lire une date d'embauche avant un point de fin de période d'essai. Ou récupérer un email professionnel, tout simplement.
04

Get many employees

employee.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie la liste des salariés, un item par personne. C'est le point de départ habituel de tout ce qui boucle sur l'ensemble de l'effectif.

Paramètres clés

  • Return All : activé, n8n enchaîne les pages de l'API jusqu'au dernier salarié. Désactivé, il s'arrête à Limit.
  • Limit : le nombre maximal de salariés renvoyés. Pratique tant que le workflow est en test : un run sur 5 personnes se lit mieux qu'un run sur tout l'annuaire.
Cas d'usage
produire un export hebdomadaire de l'annuaire, ou alimenter une boucle qui repère les dossiers auxquels il manque une pièce.
05

Update an employee

employee.update

Ce que tu vois dans n8n

Notes & cas d'usage

Modifie une fiche existante. Le nœud vise une personne et réécrit les champs transmis, sans toucher au reste du dossier.

Paramètres clés

  • Employee ID : quelle fiche est réécrite. Une erreur ici modifie la mauvaise personne, donc mappe-le depuis une recherche plutôt que de le saisir à la main.
  • Marital Status, Mobile Phone, Employee Number : réclamés à chaque mise à jour.
  • Pay Rate, Pay Per et Pay Type : la partie rémunération, Pay Type couvrant salaire, horaire, commission et contrat.
  • Update Fields : 20 champs optionnels, dont Work Email, Work Phone, City et Country.
Cas d'usage
répercuter une augmentation validée en paie directement dans la fiche.

Employee Document

5 opérations
06

Delete an employee document

employeeDocument.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Supprime un document du dossier d'un salarié. Aucune étape d'annulation n'existe dans le workflow, donc cette opération se place derrière une condition.

Paramètres clés

  • Employee ID : le salarié dont le dossier contient le document.
  • File ID : l'identifiant du fichier à supprimer. Va le chercher avec une étape Get many employee documents plutôt que de l'écrire en dur.
Cas d'usage
retirer un contrat déposé deux fois pendant l'onboarding, ou effacer un formulaire périmé une fois que son remplaçant a été téléversé et confirmé dans le même run.
07

Download an employee document

employeeDocument.download

Ce que tu vois dans n8n

Notes & cas d'usage

Récupère le contenu réel d'un document rattaché à un salarié et le place dans le workflow en données binaires, prêt à être joint, transféré ou stocké ailleurs.

Paramètres clés

  • Employee ID : le dossier dans lequel se trouve le document.
  • File ID : quel document sortir.
  • Put Output In Field : le champ de sortie qui portera le fichier binaire. Les nœuds suivants lisent ce nom, autant le garder identique d'un workflow à l'autre.
Cas d'usage
sortir une attestation signée et la joindre à un mail pour un contrôle, sans que personne n'ouvre BambooHR.
08

Get many employee documents

employeeDocument.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Liste ce qui est classé dans le dossier d'un salarié, avec un item par document. Rien n'est téléchargé ici, seulement l'index.

Paramètres clés

  • Employee ID : la personne dont on liste les documents.
  • Return All et Limit : activé, tous les documents remontent ; sinon la liste s'arrête à Limit.
  • Simplify : renvoie une version allégée de la réponse au lieu des données brutes de l'API, suffisant quand seuls les noms et les identifiants comptent.
Cas d'usage
vérifier qu'un nouvel arrivant a bien toutes ses pièces à la fin de la première semaine, et signaler ce qui manque.
09

Update an employee document

employeeDocument.update

Ce que tu vois dans n8n

Notes & cas d'usage

Retouche les informations autour d'un document déjà classé chez un salarié : son nom, sa catégorie, sa visibilité. Le contenu du fichier, lui, ne bouge pas.

Paramètres clés

  • Employee ID et File ID : le document visé.
  • Employee Document Category Name or ID : la nouvelle catégorie du fichier, choisie dans la liste ou passée en identifiant par expression.
  • Name : le nouveau nom du fichier.
  • Share with Employee : si la personne concernée voit le document depuis son propre espace.
Cas d'usage
renommer les contrats selon une convention interne, puis les basculer en partagé une fois validés par les RH.
10

Upload an employee document

employeeDocument.upload

Ce que tu vois dans n8n

Notes & cas d'usage

Envoie un fichier du workflow vers le dossier d'un salarié. C'est par là que les documents entrent dans BambooHR sans dépôt manuel.

Paramètres clés

  • Employee ID : le dossier de destination.
  • Employee Document Category ID : où le document se range à l'intérieur de ce dossier.
  • Input Data Field Name : le champ d'entrée qui contient les données binaires. Les types de fichiers supportés sont PNG et JPEG, à vérifier avant de brancher un scanner ou une pièce jointe.
  • Share with Employee (Options) : si le dépôt est visible par la personne.
Cas d'usage
classer un formulaire scanné sous la bonne personne dès son arrivée.

File

5 opérations
11

Delete a file

file.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Supprime un fichier d'entreprise, autrement dit un document partagé qui appartient à l'organisation et non au dossier d'une personne.

Paramètres clés

  • File ID : l'identifiant du fichier à supprimer. Rien d'autre n'est demandé, et c'est précisément pour ça qu'un mauvais identifiant coûte cher ici.
Cas d'usage
retirer la note de frais de l'an dernier le jour où la nouvelle version est publiée, pour que la bibliothèque interne n'affiche jamais deux versions de la même règle côte à côte.
12

Download a file

file.download

Ce que tu vois dans n8n

Notes & cas d'usage

Ramène un fichier d'entreprise dans le workflow en données binaires. Même logique que la version salarié, un cran au-dessus : le document appartient à l'entreprise, pas à une personne.

Paramètres clés

  • File ID : quel fichier d'entreprise sortir.
  • Put Output In Field : le champ de sortie qui reçoit les données binaires.
Cas d'usage
récupérer le guide des avantages en vigueur et le joindre à chaque mail de bienvenue, pour que les nouveaux reçoivent la version du jour et pas une copie oubliée sur un disque dur.
13

Get many files

file.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Liste les fichiers d'entreprise, sans passer par un salarié. C'est l'index de la bibliothèque documentaire partagée.

Paramètres clés

  • Return All : activé, n8n parcourt toute la bibliothèque ; désactivé, il s'arrête à Limit.
  • Limit : le plafond du nombre de fichiers renvoyés.
  • Simplify : une réponse allégée plutôt que les données brutes, largement suffisant pour retrouver un nom et attraper un identifiant.
Cas d'usage
retrouver le File ID d'un document interne à partir de son nom, puis le passer à une étape de téléchargement ou de mise à jour dans le même workflow.
14

Update a file

file.update

Ce que tu vois dans n8n

Notes & cas d'usage

Réorganise un fichier d'entreprise sans toucher à son contenu : nouveau nom, nouvelle catégorie, partage différent.

Paramètres clés

  • File ID : le fichier d'entreprise concerné.
  • Category Name or ID : déplace le fichier vers une autre catégorie, choisie dans la liste ou passée en identifiant par expression.
  • Name : le nouveau nom du fichier.
  • Share with Employee : si le fichier est partagé.
Cas d'usage
lancer un rangement mensuel qui renomme tout ce qui finit par « v2 final » et remet les documents égarés dans la catégorie qui leur revient.
15

Upload a file

file.upload

Ce que tu vois dans n8n

Notes & cas d'usage

Publie un document dans la bibliothèque de l'entreprise, accessible à l'organisation plutôt qu'au dossier d'un seul salarié.

Paramètres clés

  • Input Data Field Name : le champ d'entrée qui porte les données binaires. Types de fichiers supportés : PNG et JPEG.
  • Category Name or ID : la catégorie d'arrivée, prise dans la liste ou fournie par expression.
  • Share with Employee (Options) : si tout le monde le voit ou seulement les RH.
Cas d'usage
publier l'organigramme mis à jour chaque trimestre et laisser le workflow le ranger toujours au même endroit.
Besoin d'aide

Besoin d'aide pour automatiser BambooHR avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

BambooHR et n8n, les questions qui reviennent

01L'intégration BambooHR n8n est-elle gratuite ?
Oui, côté n8n. Le nœud BambooHR est livré avec n8n : rien à installer, aucun coût supplémentaire, que tu sois sur n8n Cloud ou sur une instance auto-hébergée via Docker ou npm, 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 d'un côté et déployer de l'autre. Ce que coûte BambooHR relève de ton contrat avec l'éditeur, c'est une question séparée de ce que facture n8n. Les 15 opérations sont disponibles dès que le nœud est posé sur le canvas, sans palier ni activation particulière.
02Quels credentials faut-il pour connecter BambooHR à n8n ?
Un credential par clé API, et c'est la seule méthode d'authentification supportée par ce nœud. Deux valeurs à fournir : le sous-domaine, c'est-à-dire la portion située entre le préfixe https et le suffixe .bamboohr.com dans l'adresse que ton équipe utilise, et une clé API générée depuis la section authentification de la documentation getting started de l'API BambooHR. Il faut évidemment un compte BambooHR au préalable. Dans n8n, le credential s'enregistre une fois dans le menu Credentials, puis chaque nœud BambooHR le propose dans sa liste déroulante. La clé porte les droits du compte qui l'a générée : ce que ce compte ne voit pas n'apparaîtra pas dans les résultats.
03Quelles sont les limites du nœud BambooHR dans n8n ?
Le nœud couvre 15 opérations sur 4 ressources : rapports d'entreprise, salariés, documents de salarié et fichiers d'entreprise. Tout ce qui sort de ce catalogue passe par le nœud HTTP Request, qui appelle n'importe quel autre endpoint de l'API BambooHR en réutilisant le même credential via l'authentification prédéfinie. Tu gardes donc un seul jeu de clés. À l'intérieur du nœud, deux comportements comptent. Les opérations de liste ne parcourent l'ensemble des pages que si Return All est activé, sinon Limit plafonne le résultat. Et les deux opérations d'upload précisent leurs types de fichiers supportés, PNG et JPEG, détail sur lequel on bute vite en branchant une pièce jointe.
04Peut-on déclencher un workflow depuis un événement BambooHR ?
Pas depuis BambooHR directement, car cet outil n'a pas de nœud trigger dans n8n. Un workflow qui touche à BambooHR démarre donc autrement. Le schéma le plus courant reste le Schedule Trigger, à intervalle fixe : un run chaque matin qui appelle employee.getAll et compare la liste à celle de la veille. Deuxième schéma, le nœud Webhook de n8n, c'est-à-dire une URL qu'un service tiers appelle quand quelque chose se passe chez lui, par exemple ton outil de recrutement au moment de la signature. Troisième schéma, le trigger d'un autre outil déjà en place. Ensuite seulement, le nœud BambooHR lit ou écrit.
05n8n ou Make pour BambooHR ?
Ça dépend d'où tu veux que les données vivent et de comment tu veux payer. Make est hébergé par Make, sans option d'auto-hébergement, et facture à l'opération : un workflow qui boucle sur tout l'effectif voit son coût grandir avec l'effectif. n8n tourne sur Cloud ou sur ton propre serveur avec Docker ou npm, ce qui pèse dans la balance quand les données en jeu sont des dossiers du personnel. Les deux se construisent visuellement. Si quelqu'un chez toi est à l'aise avec un serveur, l'auto-hébergement garde les données RH sur une infrastructure que tu maîtrises. Si personne ne veut administrer quoi que ce soit, une plateforme hébergée est une réponse honnête.