Overview of Personio public APIs – Personio

This article provides an introduction to Personio's public APIs, webhooks, and the Developer Hub. APIs allow software applications to interact and share data. The Personio public APIs enable data exchange between Personio and other services or tools. They provide endpoints to retrieve and edit data from your Personio account.

Tip:
The Developer Hub is the main place for information on Personio's APIs and webhooks.

Access Personio public APIs

To access information about Personio's public APIs and webhooks, go to the Developer Hub. This is the main place for information on Personio's APIs and webhooks and serves as your central resource for detailed documentation.

Personio public API versions

Personio has two API versions with different API endpoints:

v1 APIs maintain existing integrations, ensuring stability and broad functionality.
v2 APIs introduce new features, expanding integration capabilities.

Both versions complement each other, providing customers with enhanced possibilities and stability.

Examples of v1 and v2 APIs

Note:
On July 31, 2026, we’ll deprecate certain v1 API endpoints for Attendances and Projects. If you currently use v1 endpoints, ask your IT team to migrate your integrations to the new version. You can find further information in the Developer Hub.

This table shows examples of the APIs available for each version. For a full list of API functionalities and endpoints, refer to the Developer Hub.

API version	API	Examples of functionality
v1	Persons	List persons Create new persons profiles Update persons information
v1	Time off	List time offs Create time offs Delete time offs
v2	Attendances	List attendances Create attendances Update attendances Get an attendance period Delete an attendance period by ID
v2	Projects	List projects Create a project Update a project Get a project Delete a project
v2	Document Management	List document details Update existing document details Delete documents Download documents
v2	Employments	List employments and jobs Update employment and job details
v2	Jobs	Lists jobs in the organization Retrieve data about a job Create or update job assignments
v2	Salary bands	Lists the salary bands in the organization Retrieve one salary band

API credentials

Learn more about how to generate and manage API credentials. Note that to build your own custom integration using our public API, you need the CorePro Personio plan.

Webhooks

Webhooks are a specific part of Personio's public APIs. Webhooks send data from Personio to your app or database when specific events happen. Visit the Developer Hub (v2) for a full list of webhooks and details about how they work.

The Developer Hub

The Developer Hub has the latest information about Personio's public APIs and webhooks. The Developer Hub has two versions:

Developer Hub (v1) supports existing APIs.
Developer Hub (v2) introduces new APIs and webhooks.

More information

Build your own integration with our APIs

Find the answers you need