- Inicio
- Recursos
- Integraciones
- BambooHR
Integración BambooHR n8nAutomatiza BambooHR con n8n.
¿Cuántas veces se copia a mano la misma ficha de empleado? La integración BambooHR n8n reúne 15 operaciones repartidas en 4 recursos: empleados, documentos de empleado, archivos de empresa e informes guardados. BambooHR no tiene nodo trigger, así que el flujo arranca desde otro sitio. Pensado para equipos de RRHH.
Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth
¿Qué resuelve la integración BambooHR n8n?
El nodo BambooHR habla con la API de BambooHR desde dentro de un flujo de trabajo. Crea y actualiza fichas de empleado, lee una ficha concreta o la plantilla entera, sube y descarga documentos asociados a una persona, ordena los archivos compartidos de la empresa y saca cualquier informe guardado en CSV, JSON, PDF, XLS o XML. Una sola credencial de clave API cubre las 15 operaciones, y el nodo viene incluido con n8n: no hay nada que instalar.
Un detalle llama la atención nada más abrir la ficha de un empleado en BambooHR: pide un Social Security Number y un State pensados para una empresa que contrata en Estados Unidos. Un equipo en España rellena esos huecos con lo que tiene o los deja aparte, y el resto de la ficha, nombre, departamento, fecha de contratación, funciona igual sea cual sea el país. Con employee.create, esa ficha nace desde un nodo de Google Sheets que ya trae la fila del alta aprobada, sin que Recursos Humanos vuelva a teclear nada.
Los documentos son otro punto de fricción habitual, sobre todo con la rotación de becarios y contratos temporales que se ve en muchas plantillas españolas. Un contrato firmado llega como adjunto a Gmail, el flujo pasa ese binario a employeeDocument.upload, y BambooHR lo archiva en la categoría correcta bajo la persona correcta, compartido con ella o reservado a RRHH. Un aviso en Slack cierra el ciclo el día en que el expediente queda completo.
Después viene el informe que Recursos Humanos entrega a nóminas o a un responsable a final de mes. companyReport.get ejecuta un informe ya guardado en BambooHR y lo devuelve como archivo en el campo de salida elegido: PDF para quien solo necesita leerlo, JSON para que un nodo posterior lo filtre antes de que salga nada de n8n.
Cuando la operación que hace falta no está entre las 15, el nodo HTTP Request llama a cualquier otro endpoint de la API de BambooHR reutilizando la misma credencial mediante la autenticación predefinida, así que sigue habiendo un único juego de claves.
Dos cosas condicionan cómo se monta el flujo. BambooHR no tiene nodo trigger, así que el arranque viene de un Schedule Trigger a intervalo fijo, de un Webhook de n8n al que llama un servicio externo, o del trigger de otra herramienta ya presente. Y las operaciones de listado solo recorren todas las páginas de la API cuando Return All está activado; si no, Limit marca el tope. Antes de montar el primer flujo conviene leer la Reseña n8n sobre el comportamiento real de la plataforma, y el Curso n8n si las expresiones todavía cuestan.
¿Cómo se conecta BambooHR con n8n?
- 01
Genera una clave API en BambooHR
Solo hay un método de autenticación soportado: la clave API. El procedimiento está en la sección de autenticación de la documentación getting started de la API de BambooHR. Detalle que conviene tener claro desde el principio: la clave hereda los permisos de la cuenta que la genera, así que créala desde un usuario que ya vea los empleados, los documentos y los informes que el flujo va a tocar.
- 02
Localiza tu subdominio
La credencial pide además un Subdomain, es decir, el trozo que va entre
https://y.bamboohr.comen la dirección que usáis a diario. Si el equipo entra porhttps://acme.bamboohr.com, el subdominio esacmey nada más. Pegar ahí la URL completa es la forma más rápida de que la primera ejecución falle sin motivo aparente. - 03
Guarda la credencial en n8n
En n8n, entra en el menú Credentials y crea una credencial de BambooHR, que es el juego de claves guardado con el que un nodo firma sus llamadas. Pega el subdominio y la clave API, guarda, y cualquier nodo BambooHR la ofrecerá en su desplegable. Una credencial vale para los 4 recursos, o sea que un segundo flujo no necesita ninguna clave nueva.
Las 15 operaciones de BambooHR en n8n
El nodo BambooHR expone 15 operaciones en 4 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.
| Recurso | Create | Get | Get Many | Update | Delete | Download | Upload |
|---|---|---|---|---|---|---|---|
| Company Report | ✓ | ||||||
| Employee | ✓ | ✓ | ✓ | ✓ | |||
| Employee Document | ✓ | ✓ | ✓ | ✓ | ✓ | ||
| File | ✓ | ✓ | ✓ | ✓ | ✓ |
Índice de operaciones
Company Report
1 operaciónGet a company report
companyReport.getLo que ves en n8n
Notas y casos de uso
Ejecuta un informe que ya existe guardado en BambooHR y lo devuelve al flujo como archivo.
Parámetros clave
- Report ID: el número del informe. Aparece al pasar el cursor por encima del nombre del informe, en la página de informes de BambooHR.
- Format: CSV, JSON, PDF, XLS o XML. El JSON deja las filas utilizables por los nodos posteriores; el PDF encaja si solo van a abrirlo.
- Put Output In Field: el nombre del campo de salida que llevará el archivo binario.
- Only Current (Options): oculta los valores con fecha futura de los campos de tipo histórico.
Employee
4 operacionesCreate an employee
employee.createLo que ves en n8n
Notas y casos de uso
Crea una ficha de empleado. La lista de campos obligatorios es larga: el nodo espera un expediente completo.
Parámetros clave
- First Name y Last Name: el bloque de identidad, mapeado desde el nodo anterior.
- Hire Date y Date of Birth: valores de tipo fecha, no texto libre.
- Social Security Number: un número de la seguridad social estadounidense con guiones (
123-45-6789), formato fijo fuera de Estados Unidos. - Department Name or ID, Division Name or ID, Location Name or ID: de la lista, o como ID por expresión.
- Synced with Trax Payroll: si entra en un calendario de pagos sincronizado con Trax Payroll.
Get an employee
employee.getLo que ves en n8n
Notas y casos de uso
Lee una ficha concreta y devuelve sus campos al flujo, para que el resto de la ejecución tenga con qué trabajar.
Parámetros clave
- Employee ID: el identificador de la persona en BambooHR, nunca su nombre. Suele venir de un nodo anterior como
{{ $json.id }}. - Field Names or IDs (Options): el conjunto de campos que quieres recuperar. Se marcan en la lista o se pasan como IDs con una expresión. Pedir tres campos en vez del expediente entero mantiene la carga ligera.
Get many employees
employee.getAllLo que ves en n8n
Notas y casos de uso
Devuelve la lista de empleados, un item por persona. Es el punto de partida habitual de todo lo que recorre la plantilla entera.
Parámetros clave
- Return All: activado, n8n encadena las páginas de la API hasta el último empleado. Desactivado, se detiene en Limit.
- Limit: el número máximo de empleados devueltos. Muy útil mientras pruebas, porque una ejecución sobre 5 personas se revisa mucho mejor que una sobre todo el directorio.
Update an employee
employee.updateLo que ves en n8n
Notas y casos de uso
Modifica una ficha que ya existe. El nodo apunta a una persona y reescribe los campos que le pasas, sin tocar el resto del expediente.
Parámetros clave
- Employee ID: qué ficha se reescribe. Si te equivocas, editas a otra persona, así que mejor mapearlo desde una búsqueda previa.
- Marital Status, Mobile Phone, Employee Number: exigidos en cada actualización.
- Pay Rate, Pay Per y Pay Type: la parte retributiva, con un Pay Type que abarca salario, hora, comisión, contrato y demás modalidades.
- Update Fields: 20 campos opcionales, entre ellos Work Email, Work Phone, City y Country.
Employee Document
5 operacionesDelete an employee document
employeeDocument.deleteLo que ves en n8n
Notas y casos de uso
Elimina un documento del expediente de una persona. En el flujo no hay paso de deshacer, así que esta operación va siempre detrás de una condición.
Parámetros clave
- Employee ID: el empleado en cuyo expediente está el documento.
- File ID: el identificador del archivo que se borra. Sácalo de un paso Get many employee documents en vez de escribirlo fijo.
Download an employee document
employeeDocument.downloadLo que ves en n8n
Notas y casos de uso
Trae el contenido real de un documento asociado a un empleado y lo deja en el flujo como datos binarios, listo para adjuntarlo, reenviarlo o guardarlo en otro sitio.
Parámetros clave
- Employee ID: en qué expediente está el documento.
- File ID: cuál de los documentos se descarga.
- Put Output In Field: el campo de salida que llevará el binario. Los nodos siguientes leen ese nombre, conviene repetirlo igual en todos tus flujos.
Get many employee documents
employeeDocument.getAllLo que ves en n8n
Notas y casos de uso
Enumera lo que hay archivado en el expediente de una persona, con un item por documento. Aquí no se descarga nada, solo el índice.
Parámetros clave
- Employee ID: de quién se listan los documentos.
- Return All y Limit: activado, vuelven todos los documentos; si no, la lista se corta en Limit.
- Simplify: devuelve una versión reducida de la respuesta en lugar de los datos crudos de la API, suficiente cuando solo necesitas nombres e identificadores.
Update an employee document
employeeDocument.updateLo que ves en n8n
Notas y casos de uso
Cambia los datos que rodean a un documento ya archivado en un expediente: cómo se llama, dónde está, quién lo ve. El contenido del archivo sigue igual.
Parámetros clave
- Employee ID y File ID: el documento sobre el que se actúa.
- Employee Document Category Name or ID: la nueva categoría del archivo, elegida en la lista o pasada como ID con una expresión.
- Name: el nuevo nombre del archivo.
- Share with Employee: si la persona lo ve desde su propio acceso.
Upload an employee document
employeeDocument.uploadLo que ves en n8n
Notas y casos de uso
Envía un archivo desde el flujo al expediente de un empleado. Es la vía por la que los documentos entran en BambooHR sin subida manual.
Parámetros clave
- Employee ID: el expediente de destino.
- Employee Document Category ID: en qué categoría se guarda dentro de ese expediente.
- Input Data Field Name: el campo de entrada con los datos binarios. Los tipos de archivo soportados son PNG y JPEG, conviene mirarlo antes de enchufar un escáner o un adjunto.
- Share with Employee (Options): si la persona ve lo que se ha subido.
File
5 operacionesDelete a file
file.deleteLo que ves en n8n
Notas y casos de uso
Borra un archivo de empresa, o sea uno de esos documentos compartidos que pertenecen a la organización y no al expediente de alguien.
Parámetros clave
- File ID: el identificador del archivo que se elimina. No se pide nada más, y justo por eso un identificador equivocado sale caro aquí.
Download a file
file.downloadLo que ves en n8n
Notas y casos de uso
Mete un archivo de empresa en el flujo como datos binarios. Misma mecánica que la versión de empleado, un nivel por encima: el documento es de la empresa, no de una persona.
Parámetros clave
- File ID: qué archivo de empresa se descarga.
- Put Output In Field: el campo de salida que recibe los datos binarios.
Get many files
file.getAllLo que ves en n8n
Notas y casos de uso
Lista los archivos de empresa sin pasar por ningún empleado. Es el índice de la biblioteca documental compartida.
Parámetros clave
- Return All: activado, n8n recorre la biblioteca completa; desactivado, se para en Limit.
- Limit: el tope de archivos devueltos.
- Simplify: una respuesta reducida en vez de los datos crudos, de sobra para localizar un nombre y quedarte con su identificador.
Update a file
file.updateLo que ves en n8n
Notas y casos de uso
Reordena un archivo de empresa sin tocar su contenido: otro nombre, otra categoría, otra visibilidad.
Parámetros clave
- File ID: el archivo de empresa afectado.
- Category Name or ID: mueve el archivo a otra categoría, elegida en la lista o pasada como ID con una expresión.
- Name: el nuevo nombre del archivo.
- Share with Employee: si el archivo queda compartido.
Upload a file
file.uploadLo que ves en n8n
Notas y casos de uso
Publica un documento en la biblioteca de la empresa, disponible para toda la organización en lugar de para un expediente concreto.
Parámetros clave
- Input Data Field Name: el campo de entrada que lleva los datos binarios. Tipos de archivo soportados: PNG y JPEG.
- Category Name or ID: la categoría de destino, sacada de la lista o pasada con una expresión.
- Share with Employee (Options): si lo ve todo el mundo o solo RRHH.
¿Necesitas ayuda para automatizar BambooHR con n8n?
El equipo te responde directamente.
Cada mensaje lo lee una persona.

