---
title: "BambooHR"
description: "Conecta BambooHR con el dominio de tu empresa, deja que Pyn lea los empleados a través de un inicio de sesión en BambooHR, y mantén al día el Directory con una actualización cada hora y notificaciones de cambios."
sidebar:
  label: Resumen
  order: 0
area: integrations
feature: bamboohr
appPath: /settings/integrations/available
lastVerified: 2026-11-15
version: "2026-11-02"
audience: admin
related:
  - integrations
  - integrations/hris-fields
  - integrations/sync-and-matching
intercom:
  - id: "11614355"
    title: Connect to BambooHR (Pyn 2)
    url: https://intercom.help/pyn/en/articles/11614355-connect-to-bamboohr-pyn-2
    note: replaces
  - id: "10100088"
    title: "BambooHR Error \"Insufficient Permissions\""
    url: https://intercom.help/pyn/en/articles/10100088-bamboohr-error-insufficient-permissions
    note: replaces
  - id: "6024101"
    title: Why is employee data from BambooHR not appearing in Pyn?
    url: https://intercom.help/pyn/en/articles/6024101-why-is-employee-data-from-bamboohr-not-appearing-in-pyn
    note: replaces
  - id: "6330100"
    title: Connect to BambooHR (Pyn 1)
    url: https://intercom.help/pyn/en/articles/6330100-connect-to-bamboohr-pyn-1
    note: "Pyn 1 article, kept for reference"
translation:
  source: integrations/bamboohr/index.mdx
  sourceSha: c75c1409d92ecf48831371f6ed3d872a20c0df1c
---

La integración con BambooHR lee tu directorio de empleados y un informe personalizado a través de la API de BambooHR, de modo que las fechas de inicio, los departamentos, los managers y los empleados salientes mueven tus flows sin una hoja de cálculo. En los workspaces donde el webhook de BambooHR está habilitado, BambooHR también notifica a Pyn los cambios entre actualizaciones.

## Antes de empezar

- Eres administrador o propietario en Pyn.
- Conoces el dominio de empresa de BambooHR: la parte anterior a `.bamboohr.com` en tu dirección de BambooHR.
- Puedes iniciar sesión en BambooHR con una cuenta que tenga acceso a la API y pueda ver los campos que quieres sincronizar. Una cuenta de servicio que no sea de un empleado es mejor que el inicio de sesión de una persona, que deja de funcionar cuando esa persona se va.

![Connect to BambooHR asks for your Company Domain.](https://support.pyn.ai/media/integrations/bamboohr/integrations-bamboohr-connect.png)

## Conecta

1. En Pyn, abre **Settings** en la navegación izquierda y después **Available** bajo **Integrations**.

2. Selecciona el mosaico **BambooHR**. Se abre el diálogo **Connect to BambooHR**.

3. Introduce tu **Company Domain**. Puedes pegar la dirección completa, como `https://acme.bamboohr.com`; Pyn se queda con `acme`. "This is not a valid company domain." significa que no parece un subdominio de BambooHR.

4. Selecciona **Connect**. Se abre BambooHR; inicia sesión y selecciona **Allow Access**.

5. BambooHR te devuelve a Pyn. El panel dice "You're connected. Syncing can take a few minutes. Check the journey map then!" Si en BambooHR rechazas el acceso, o tardas demasiado allí, aterrizas en **Installed** con un toast titulado **BambooHR wasn't connected** que explica el motivo: "You didn't grant access, so nothing was connected." o "The sign-in took too long, so nothing was connected. Try again."

## Qué se sincroniza

Pyn actualiza aproximadamente una vez por hora; una ejecución en la que el informe no ha cambiado se registra como "Successfully integrated to BambooHR. No employee changes found". En los workspaces donde el webhook está habilitado, las notificaciones de cambios de BambooHR se registran bajo **History** a medida que llegan. La pestaña **Details** muestra el **Subdomain**, la **Primary Source** (Custom Report o Directory), la **Last Refresh** y la **Last Successful Refresh**; la pestaña **Advanced** enumera los **Fields in Report** con un recuento por campo.

| Propiedad en Pyn | Desde BambooHR |
| --- | --- |
| Nombre para mostrar, nombre legal, nombre preferido | El nombre para mostrar, el nombre completo y el nombre preferido |
| Correo de trabajo, correo personal | El correo de trabajo y el correo personal |
| Fecha de inicio | La fecha de contratación; una fecha de contratación original anterior marca a un empleado que vuelve |
| Fecha de baja, estado | La fecha de baja; un estado de empleo distinto de Active pasa a inactivo |
| Departamento, división, ubicación, puesto | Los campos equivalentes de BambooHR |
| Tipo de empleo | El estado del historial de empleo |
| Manager | El id de empleado del supervisor |
| Cumpleaños, país, código postal, zona horaria | El cumpleaños y la dirección; la zona horaria a partir del país y el código postal |

Si la cuenta con la que se conectó Pyn solo puede leer el directorio, el panel avisa: "This integration is pulling limited employee data from the BambooHR directory. To get a complete employee profile, have a BambooHR administrator reconnect this integration, or ask for expanded permissions." Consulta [Campos del HRIS](https://support.pyn.ai/es/integrations/hris-fields/) para la matriz de campos.

## Pruébalo

Abre el mosaico de BambooHR bajo **Installed**, abre el menú **...** y selecciona **Test Connection**. "Successfully tested the connection to BambooHR." lo confirma; "An error occurred connecting to BambooHR. Please Reconnect or contact support if the issue persists." significa que el inicio de sesión ya no funciona. Después comprueba [Employees](https://support.pyn.ai/es/directory/employees/).

## Reconecta o desconecta

- **Reconnect** repite el inicio de sesión en BambooHR para el mismo dominio de empresa. Úsalo cuando cambie la contraseña de la cuenta conectada o se amplíen sus permisos.
- **Deactivate** detiene la sincronización; **Activate** la reanuda. **Archive** quita la integración de Installed; los empleados sincronizados se conservan. Si alguna de las dos falla, un aviso dice **Could not deactivate the integration** o **Could not archive the integration** y nada cambia.

## Solución de problemas

| Qué ves | Qué significa |
| --- | --- |
| History: "Error: Insufficient permissions to access BambooHR" | El nivel de acceso de la cuenta conectada perdió permisos de API o de campos. En BambooHR, abre **Access Levels > Custom Levels**, selecciona el nivel y, bajo **Access Level Settings**, permite **Settings > Company Field Settings**; después reconecta. |
| History: "Error: Authentication failed, please reconnect" | El inicio de sesión caducó o se revocó. Reconecta. |
| History: "Could not connect to BambooHR, please reconnect" | BambooHR rechazó la conexión. Reconecta; si se repite, contacta con soporte. |
| History: "BambooHR returned data in an unexpected format" (en ámbar) | Una actualización recibió una respuesta que Pyn no pudo leer, normalmente algo puntual, así que la integración sigue activa y la siguiente actualización lo vuelve a intentar. Si se repite en cada ejecución, contacta con soporte. |
| Los empleados dejan de actualizarse cuando alguien se va | La integración se conectó con el inicio de sesión de esa persona. Reconecta con una cuenta que no sea de un empleado. |
| Campos como la fecha de inicio están en blanco | Están vacíos en BambooHR, o la cuenta no puede verlos. Comprueba el recuento de campos bajo Advanced. |

## Relacionado

- [Integrations](https://support.pyn.ai/es/integrations/) para el catálogo.
- [Campos del HRIS](https://support.pyn.ai/es/integrations/hris-fields/) para la matriz de campos.
- [Cadencia de sincronización y emparejamiento](https://support.pyn.ai/es/integrations/sync-and-matching/) para calendarios y emparejamiento.
