Resumen de las API públicas de Personio – Personio

Este artículo proporciona una introducción a las API públicas de Personio, los webhooks y el Developer Hub. Las API permiten que las aplicaciones de software interactúen y compartan datos. Las API públicas de Personio permiten el intercambio de datos entre Personio y otros servicios o herramientas. Proporcionan endpoints para recuperar y editar datos de tu cuenta de Personio.

Consejo:
El Developer Hub es el lugar principal para obtener información sobre las API y los webhooks de Personio.

Acceder a las API públicas de Personio

Para acceder a la información sobre las API públicas y los webhooks de Personio, ve al Developer Hub. Este es el lugar principal para obtener información sobre las API y los webhooks de Personio y sirve como recurso central para obtener documentación detallada.

Versiones de API públicas de Personio

Personio tiene dos versiones de API con diferentes puntos finales de API:

Las API v1 mantienen las integraciones ya configuradas, lo que garantiza la estabilidad y una amplia funcionalidad.
Las API v2 introducen nuevas funciones y amplían las capacidades de integración.

Ambas versiones se complementan entre sí, ofreciendo a los clientes mayores posibilidades y estabilidad.

Ejemplos de API v1 y v2

Ten en cuenta que:
El 31 de julio de 2026, depreciaremos ciertos endpoints de v1 API para Asistencias y Proyectos. Si actualmente utilizas endpoints v1, solicita a tu equipo de TI que migre sus Integraciones a la nueva versión. Puedes encontrar más información en el Developer Hub.

Esta tabla muestra ejemplos de las API disponibles para cada versión. Para obtener una lista completa de las funcionalidades de la API y los endpoints, consulta el Developer Hub.

Versión de la API	API	Ejemplos de funcionalidad
v1	Personas	Enumerar a las personas Crear perfiles de personas Actualizar la información de las personas
v1	Ausencia	Lista de ausencias Crear ausencias Eliminar ausencias
v2	Registros de jornada	Lista de asistencias Crear asistencias Actualizar asistencias Obtener un periodo de registro de jornada Eliminar un periodo de registro de jornada por ID
v2	Proyectos	Listar proyectos Crear un proyecto Actualización de un proyecto Obtener un proyecto Eliminar un proyecto
v2	Gestión de documentos	Editar detalles del documento Actualizar los detalles de los documentos ya creados Eliminar documentos Descargar documentos
v2	Empleos	Enumerar empleos Actualizar los detalles de los empleos
v2	Puestos	Enumerar los empleos de la organización Recuperar datos sobre un empleo Crear o actualizar asignaciones de empleos
v2	Bandas salariales	Enumera las bandas salariales de la organización Recupera una banda salarial
v2	Informes	Recuperar datos de informes personalizados, incluyendo cambios históricos en los atributos de los empleados (como el historial de salarios)

Credenciales de API

Encontrarás más información en el artículo Generar y administrar credenciales de API. Ten en cuenta que para construir tu propia integración personalizada utilizando nuestra API pública, necesitas el plan CorePro Personio.

Webhooks

Los webhooks son una parte específica de las API públicas de Personio. Los webhooks envían datos desde Personio a tu aplicación o base de datos cuando suceden eventos específicos. Visita el Developer Hub (v2) para obtener una lista completa de webhooks y detalles sobre cómo funcionan.

El Developer Hub

El Developer Hub tiene la información más reciente sobre las API públicas y los webhooks de Personio. El Developer Hub tiene dos versiones:

Developer Hub (v1) es compatible con las API ya configuradas.
El Developer Hub (v2) presenta nuevas API y webhooks.

Para acceder a los archivos OpenAPI v2, ve a developer.personio.de/openapi.

Más información

Crea tu propia integración con nuestras API

Encuentra las respuestas que buscas