API abierta y webhooks de PeopleForce para integraciones a medida

Formas de conectar

¿Cómo quieres conectarlo?

La mayoría de las conexiones no necesita desarrolladores. Empieza por el nivel que mejor encaje con tu equipo.

Sin desarrolladores: una app lista en Zapier

Nuestra app oficial en Zapier trae 13 disparadores y 3 acciones: contrataciones, desvinculaciones, cambios de posición y salario, solicitudes de ausencia y ofertas aceptadas. Conéctala con una clave API de la empresa y elige la app del otro lado.

Low code: tu propia herramienta de automatización

n8n, Make o cualquier herramienta que trabaje con HTTP funciona con la misma clave API y los mismos webhooks. Hay equipos que ya gestionan así los referidos, los ajustes de horas extra y los tickets de onboarding.

Tu equipo técnico: una integración a medida

Una API REST documentada que lee y escribe datos de personas, estructura organizacional, compensación, ausencias, registro de tiempo y reclutamiento, con especificaciones OpenAPI publicadas. Construye sobre ella un dashboard, un portal o un asistente.

Datos disponibles

¿Qué datos puedes leer y escribir?

PeopleForce sigue siendo la fuente de verdad de los datos de personas. Todo lo que ves abajo se puede llevar a tus sistemas, escribir de vuelta o ambas cosas.

Objeto	Lectura	Escritura	Eventos de webhooks
Personas y perfiles	Sí	Sí	Contratación, actualización, primer día, desvinculación
Estructura organizacional	Sí	Sí	Cambios de posición y de perfil de puesto
Compensación	Sí	Sí	Cambios de salario y de pagos adicionales
Ausencias	Sí	Sí	Creación, aprobación, rechazo, retiro, eliminación
Horas extra	Sí	Sí	Creación, actualización, aprobación, eliminación
Registro de tiempo	Sí	Sí	—
Reclutamiento	Sí	Sí	Candidato, vacante, postulación, avance en el pipeline, oferta
Desempeño	Sí	Solo KPI	—
Encuestas	Solo v4	—	Lanzamiento de encuesta

Los datos de salario y compensación necesitan un permiso propio en la clave. Los datos de encuestas se leen con la API v4, más nueva, que usa una clave de cuenta de servicio en lugar de la clave de la empresa.

Referencia completa de endpoints y detalle de campos

Todo está en la documentación para desarrolladores

Documentación para desarrolladores

Eventos

¿Qué pasa en el momento en que cambian los datos?

En lugar de consultarnos según un horario, suscríbete a 36 eventos y deja que PeopleForce avise a tus sistemas cuando algo pase.

Entregas firmadas

Se entregan en tu endpoint HTTPS. Define un secreto y cada entrega se firma con HMAC‑SHA256, así puedes verificar que viene de nosotros.

Un registro de cada entrega

Cada entrega queda registrada con su solicitud y su respuesta, y puedes reenviarla desde la pantalla de configuración.

Configuración en la interfaz o a través de la API

Los endpoints se configuran en la interfaz, y también puedes crearlos o eliminarlos a través de la API.

Grupo	Eventos
Personas	Creación, actualización, primer día, desvinculación, cancelación de la desvinculación
Compensación	Cambio de salario, pago adicional agregado o modificado, cambio de estado laboral
Ausencias	Creación, aprobación, rechazo, retiro, eliminación
Horas extra	Creación, actualización, aprobación, eliminación
Reclutamiento	Candidato creado o eliminado, vacante creada, postulación creada, avance en el pipeline, oferta aceptada o rechazada
Estructura y acceso	Posiciones, perfiles de puesto, filas de tablas personalizadas, usuarios externos, lanzamiento de encuesta

Cómo funciona

Cómo funciona de principio a fin

Una nueva incorporación, cuatro pasos y nadie volviendo a tipear datos.

1. Se agrega una nueva incorporación

HR completa el perfil en PeopleForce, como ya lo hace hoy.

2. PeopleForce envía el evento

Tu endpoint recibe un webhook firmado con la persona y su fecha de ingreso.

3. Tus sistemas actúan

Se crean las cuentas, se abre un ticket para la laptop y se otorgan los accesos.

4. El resultado vuelve

Tu flujo escribe los datos de las cuentas de vuelta en el perfil a través de la API.

Por dónde empezar

La clave pertenece a la empresa, así que nada depende de que una persona siga en el equipo.

1. Crea una clave API

Configuración → Claves API, disponible para cualquier rol al que le des acceso a esa configuración. La clave se muestra una sola vez y pertenece a la empresa, no a la persona que la creó.

2. Llama a tu primer endpoint

Envía la clave en el encabezado de la solicitud y lee tus personas, departamentos o vacantes.

3. Suscríbete a los eventos que te interesan

Una persona administradora agrega un endpoint de webhook, elige sus temas y revisa el registro de entregas.

Hoy, 300 solicitudes por minuto por clave	Alcanza para traer unos miles de personas en una sincronización nocturna. Si lo superas, la respuesta te indica cuánto esperar antes de reintentar.
Cada clave se puede limitar a tus direcciones	Agrega una lista de IP permitidas a una clave y solo funcionará desde tus servidores.
La especificación está publicada	Genera un cliente en tu propio lenguaje en lugar de escribir cada solicitud a mano.
Las versiones anteriores siguen disponibles	Las versiones uno a tres comparten las mismas rutas, así que una integración escrita para una versión anterior sigue funcionando. La versión cuatro es una API aparte y más nueva, a la que pasas cuando necesitas lo que agrega.