- Accueil
- Ressources
- Intégrations
- BambooHR
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
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.
Comment connecter BambooHR à n8n ?
- 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.
- 02
Récupérer le sous-domaine
Le credential demande aussi un Subdomain, c'est-à-dire la portion comprise entre
https://et.bamboohr.comdans l'adresse utilisée tous les jours. Si l'équipe se connecte surhttps://acme.bamboohr.com, le sous-domaine vautacme, rien de plus. Coller l'URL complète dans ce champ reste le meilleur moyen de rater sa première exécution. - 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é.
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.
| Ressource | Create | Get | Get Many | Update | Delete | Download | Upload |
|---|---|---|---|---|---|---|---|
| Company Report | ✓ | ||||||
| Employee | ✓ | ✓ | ✓ | ✓ | |||
| Employee Document | ✓ | ✓ | ✓ | ✓ | ✓ | ||
| File | ✓ | ✓ | ✓ | ✓ | ✓ |
Sommaire des opérations
Company Report
1 opérationGet a company report
companyReport.getCe 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.
Employee
4 opérationsCreate an employee
employee.createCe 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.
Get an employee
employee.getCe 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.
Get many employees
employee.getAllCe 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.
Update an employee
employee.updateCe 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.
Employee Document
5 opérationsDelete an employee document
employeeDocument.deleteCe 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.
Download an employee document
employeeDocument.downloadCe 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.
Get many employee documents
employeeDocument.getAllCe 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.
Update an employee document
employeeDocument.updateCe 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.
Upload an employee document
employeeDocument.uploadCe 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.
File
5 opérationsDelete a file
file.deleteCe 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.
Download a file
file.downloadCe 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.
Get many files
file.getAllCe 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.
Update a file
file.updateCe 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é.
Upload a file
file.uploadCe 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.
Besoin d'aide pour automatiser BambooHR avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.

