Recursos · Integración n8n

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

Por qué automatizar

¿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.

Conexión

¿Cómo se conecta BambooHR con n8n?

  1. 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.

  2. 02

    Localiza tu subdominio

    La credencial pide además un Subdomain, es decir, el trozo que va entre https:// y .bamboohr.com en la dirección que usáis a diario. Si el equipo entra por https://acme.bamboohr.com, el subdominio es acme y 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.

  3. 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.

Acciones

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.

Matriz recursos × operaciones
RecursoCreateGetGet ManyUpdateDeleteDownloadUpload
Company Report✓
Employee✓✓✓✓
Employee Document✓✓✓✓✓
File✓✓✓✓✓

Company Report

1 operación
01

Get a company report

companyReport.get

Lo 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.
Casos de uso
mandar el informe de plantilla cada lunes, o comparar el JSON con el del mes pasado.

Employee

4 operaciones
02

Create an employee

employee.create

Lo 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.
Casos de uso
convertir un alta validada en ficha real.
03

Get an employee

employee.get

Lo 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.
Casos de uso
recuperar el correo profesional antes de mandar un aviso interno, o leer la fecha de contratación para saber si toca revisar el periodo de prueba.
04

Get many employees

employee.getAll

Lo 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.
Casos de uso
generar un export semanal del directorio, o alimentar un bucle que detecta a quién le falta un documento.
05

Update an employee

employee.update

Lo 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.
Casos de uso
llevar una subida ya aprobada en nóminas hasta la ficha.

Employee Document

5 operaciones
06

Delete an employee document

employeeDocument.delete

Lo 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.
Casos de uso
quitar un contrato subido dos veces durante el onboarding, o borrar un impreso caducado en cuanto su sustituto se ha subido y confirmado en la misma ejecución.
07

Download an employee document

employeeDocument.download

Lo 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.
Casos de uso
sacar un anexo firmado y adjuntarlo a un correo para una revisión, sin que nadie tenga que abrir BambooHR.
08

Get many employee documents

employeeDocument.getAll

Lo 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.
Casos de uso
comprobar que un recién llegado tiene toda su documentación al cerrar la primera semana, y señalar lo que falta.
09

Update an employee document

employeeDocument.update

Lo 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.
Casos de uso
renombrar los contratos siguiendo una convención interna y ponerlos en compartido cuando RRHH da el visto bueno.
10

Upload an employee document

employeeDocument.upload

Lo 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.
Casos de uso
archivar un impreso escaneado bajo la persona correcta nada más recibirlo.

File

5 operaciones
11

Delete a file

file.delete

Lo 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í.
Casos de uso
retirar la política de gastos del año pasado el mismo día en que se publica la nueva, para que la biblioteca interna no muestre nunca dos versiones de la misma norma a la vez.
12

Download a file

file.download

Lo 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.
Casos de uso
coger la guía de beneficios vigente y adjuntarla a cada correo de bienvenida, para que quien entra reciba la versión de hoy y no una copia guardada en el escritorio de alguien.
13

Get many files

file.getAll

Lo 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.
Casos de uso
encontrar el File ID de un documento interno a partir de su nombre y pasárselo a un paso de descarga o de actualización en el mismo flujo.
14

Update a file

file.update

Lo 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.
Casos de uso
lanzar una limpieza mensual que renombre todo lo que acaba en « definitivo bueno » y devuelva los documentos sueltos a la categoría que les toca.
15

Upload a file

file.upload

Lo 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.
Casos de uso
publicar el organigrama actualizado cada trimestre y dejar que el flujo lo coloque siempre en el mismo sitio.
Necesitas ayuda

¿Necesitas ayuda para automatizar BambooHR con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

BambooHR y n8n, las dudas más frecuentes

01¿La integración BambooHR n8n es gratis?
Sí, por el lado de n8n. El nodo de BambooHR viene incluido con n8n: no hay nada que instalar ni coste adicional, tanto si usas n8n Cloud como si te lo autoalojas con Docker o npm en la Community Edition bajo licencia Sustainable Use. Un flujo se comporta igual en los dos escenarios, así que puedes montarlo en uno y llevarlo al otro sin rehacerlo. Lo que cueste BambooHR depende de tu contrato con ellos, que es una cuestión aparte de lo que factura n8n. Las 15 operaciones están disponibles desde el momento en que colocas el nodo en el lienzo.
02¿Qué credenciales hacen falta para conectar BambooHR con n8n?
Una credencial de clave API, que es el único método de autenticación soportado por este nodo. Se rellenan dos valores: el subdominio, es decir el trozo entre https:// y .bamboohr.com de la dirección con la que entra tu equipo, y una clave API generada desde la sección de autenticación de la documentación getting started de la API de BambooHR. Antes de nada hace falta una cuenta de BambooHR. En n8n la credencial se guarda una vez en el menú Credentials y después cualquier nodo de BambooHR la ofrece en su desplegable. Ojo con los permisos: la clave lleva los de la cuenta que la creó, y lo que esa cuenta no ve tampoco saldrá en los resultados.
03¿Qué limites tiene el nodo de BambooHR en n8n?
El nodo cubre 15 operaciones sobre 4 recursos: informes de empresa, empleados, documentos de empleado y archivos de empresa. Todo lo que queda fuera de ese catálogo se resuelve con el nodo HTTP Request, que llama a cualquier otro endpoint de la API de BambooHR reutilizando la misma credencial con la autenticación predefinida, así que sigues gestionando un único juego de claves. Dentro del nodo hay dos comportamientos que conviene tener presentes. Las operaciones de listado solo recorren todas las páginas si Return All está activado; si no, Limit marca el tope. Y las dos operaciones de subida indican sus tipos de archivo soportados, PNG y JPEG.
04¿Se puede lanzar un flujo desde un evento de BambooHR?
Desde BambooHR no, porque esta herramienta no tiene nodo trigger en n8n. Un flujo que toque BambooHR arranca por otro lado. El patrón más común es el Schedule Trigger a intervalo fijo: una ejecución cada mañana que llama a employee.getAll y compara la lista con la del día anterior. El segundo patrón es el nodo Webhook de n8n, o sea una URL a la que llama un servicio externo cuando pasa algo en su lado, por ejemplo tu herramienta de selección al firmarse un contrato. El tercero es el trigger de otra herramienta que ya tengas montada. A partir de ahí, el nodo BambooHR lee o escribe.
05¿n8n o Make para BambooHR?
Depende de dónde quieras que vivan los datos y de cómo prefieras pagar. Make lo aloja Make, sin opción de autoalojamiento, y factura por operación: un flujo que recorre toda la plantilla tiene un coste que crece con el número de personas. n8n funciona en Cloud o en tu propio servidor con Docker o npm, algo que pesa bastante cuando lo que circula son expedientes de personal. Los dos se montan de forma visual. Si en tu equipo hay alguien cómodo administrando un servidor, autoalojar deja los datos de RRHH en una infraestructura que controlas tú. Si nadie quiere mantener nada, una plataforma alojada es una respuesta razonable.