> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Personio

> How to set up the Personio connector, plus the actions and events that are available.

![Personio](https://stackone-logos.com/api/personio/filled/svg)

v2.0.1[See changelog](https://docs.stackone.com/connectors/personio/changelog.md)

[54 actions](#actions) · [21 events](#events) · 1 auth method

HRIS
ATS

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [OAuth 2.0 · Connector Profile](https://docs.stackone.com/connectors/personio/guides/connector-profile/oauth-2-0.md)
>
> Requires a custom integration in Personio. Access is limited to the modules granted to that integration.

Optionally, configure receiving Events for Personio into StackOne.

> [card] [Webhooks setup](https://docs.stackone.com/connectors/personio/guides/webhook-setup.md)

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [OAuth 2.0 · Link Account](https://docs.stackone.com/connectors/personio/guides/link-account/oauth-2-0.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Scopes

Select all
|
Clear

personio:absences:read

personio:absences:write

personio:attendances:read

personio:attendances:write

personio:compensations:read

personio:compensations:write

personio:documents:read

personio:documents:write

personio:persons:read

personio:persons:write

personio:recruiting:read

No scopes found

54 actions

ActionDescriptionRequired scopes

Get Absence Type`personio_get_absence_type`

Retrieve a specific absence type by ID.

`personio:absences:read`

List Absence Types`personio_list_absence_types`

Retrieve all available absence types configured in Personio.

`personio:absences:read`

List Absence Periods`personio_list_absence_periods`

Retrieve absence periods with comprehensive filtering options.

`personio:absences:read`

Create Absence Period`personio_create_absence_period`

Create a new absence period for a person.

`personio:absences:write`

Get Absence Period`personio_get_absence_period`

Retrieve a specific absence period by ID.

`personio:absences:read`

Get Absence Period Breakdowns`personio_get_absence_period_breakdowns`

Retrieve detailed daily breakdown for an absence period.

`personio:absences:read`

Update Absence Period`personio_update_absence_period`

Update an existing absence period.

`personio:absences:write`

Delete Absence Period`personio_delete_absence_period`

Remove an absence period by ID.

`personio:absences:write`

Get Absence Balance`personio_get_absence_balance`

Retrieve the absence balance for a specific employee across all absence types.

`personio:absences:read`

List Attendance Periods`personio_list_attendance_periods`

Retrieve attendance periods with comprehensive filtering options.

`personio:attendances:read`

Get Attendance Period`personio_get_attendance_period`

Retrieve a specific attendance period by ID.

`personio:attendances:read`

Create Attendance Period`personio_create_attendance_period`

Create a new attendance period for an employee.

`personio:attendances:write`

Update Attendance Period`personio_update_attendance_period`

Update an existing attendance period.

`personio:attendances:write`

Delete Attendance Period`personio_delete_attendance_period`

Remove an attendance period.

`personio:attendances:write`

List Compensations`personio_list_compensations`

Retrieve compensation records for persons within a date range.

`personio:compensations:read`

Create Compensation`personio_create_compensation`

Create a new compensation record for a person.

`personio:compensations:write`

List Compensation Types`personio_list_compensation_types`

Retrieve all available compensation types configured in Personio.

`personio:compensations:read`

Create Compensation Type`personio_create_compensation_type`

Create a new compensation type in Personio.

`personio:compensations:write`

List Cost Centers`personio_list_cost_centers`

Retrieve all cost centers with filtering and pagination.

`personio:persons:read`

List Documents`personio_list_documents`

Retrieve document metadata with filtering and pagination.

`personio:documents:read`

Update Document Metadata`personio_update_document`

Update metadata for an existing document.

`personio:documents:write`

Delete Document`personio_delete_document`

Delete a document from Personio document management.

`personio:documents:write`

List Document Categories`personio_list_document_categories`

Retrieve all document categories for the company (record fields are nested under `attributes`, e.g. `attributes.name`).

`personio:documents:read`

Upload Document`personio_upload_document`

Upload a document for a company employee.

`personio:documents:write`

Download Document`personio_download_document`

Download a document file from Personio document management.

`personio:documents:read`

List Legal Entities`personio_list_legal_entities`

Retrieve all legal entities configured in Personio.

`personio:persons:read`

Get Legal Entity`personio_get_legal_entity`

Retrieve a specific legal entity by ID.

`personio:persons:read`

List Employee Attributes`personio_list_employee_attributes`

List all allowed employee attributes including custom (dynamic) attributes.

`personio:persons:read`

List Employees`personio_list_persons`

Retrieve a paginated list of all persons with their attributes.

`personio:persons:read`

Get Person`personio_get_person`

Retrieve a specific person by ID with full details including custom attributes.

`personio:persons:read`

Delete Person`personio_delete_person`

Permanently delete a person record from Personio.

`personio:persons:write`

Create Employee`personio_create_person`

Create a new person with initial employment record in Personio.

`personio:persons:write`

Update Employee`personio_update_person`

Update person-level information for an existing employee.

`personio:persons:write`

List Person Employments`personio_list_person_employments`

Retrieve all employment records for a specific person.

`personio:persons:read`

Get Employment`personio_get_employment`

Retrieve a specific employment record with full details.

`personio:persons:read`

Update Employment`personio_update_employment`

Update employment details for an existing person.

`personio:persons:write`

List Projects`personio_list_projects`

Retrieve time tracking projects with filtering and pagination.

`personio:attendances:read`

Get Project`personio_get_project`

Retrieve a specific project by ID.

`personio:attendances:read`

Create Project`personio_create_project`

Create a project and return the newly created project ID.

`personio:attendances:write`

Update Project`personio_update_project`

Update a project by the provided project ID.

`personio:attendances:write`

Delete Project`personio_delete_project`

Remove a project and all its sub-projects by ID.

`personio:attendances:write`

List Project Members`personio_list_project_members`

Retrieve all members assigned to a specific project.

`personio:attendances:read`

Add Project Members`personio_add_project_members`

Add members to a project by providing a list of person IDs.

`personio:attendances:write`

Remove Project Members`personio_remove_project_members`

Remove members from a project, either individually or all at once.

`personio:attendances:write`

List Applications`personio_list_applications`

Retrieve all recruiting applications with filtering and pagination.

`personio:recruiting:read`

Get Application`personio_get_application`

Retrieve a specific recruiting application by ID.

`personio:recruiting:read`

Get Application Stage Transitions`personio_get_application_stage_transitions`

Retrieve stage transition history for a recruiting application.

`personio:recruiting:read`

List Candidates`personio_list_candidates`

Retrieve all recruiting candidates with filtering and pagination.

`personio:recruiting:read`

Get Candidate`personio_get_candidate`

Retrieve a specific recruiting candidate by ID.

`personio:recruiting:read`

List Jobs`personio_list_jobs`

Retrieve all recruiting jobs with filtering and pagination.

`personio:recruiting:read`

Get Job`personio_get_job`

Retrieve a specific recruiting job by ID.

`personio:recruiting:read`

List Categories`personio_list_categories`

Retrieve all recruiting job categories with their pipeline stages.

`personio:recruiting:read`

Get Category`personio_get_category`

Retrieve a specific recruiting job category by ID.

`personio:recruiting:read`

List Workplaces`personio_list_workplaces`

Retrieve all workplaces with filtering and pagination.

`personio:persons:read`

## Events

Tags

Select all
|
Clear

Absences

Attendances

Documents

Employees

Employments

Verification

Webhooks

No tags found

21 events

EventDescriptionTags

Ping Verification`personio_webhook_ping`

Acknowledges Personio webhook ping and test deliveries without emitting an event.

Verification

Person Created`personio_webhook_person_created`

Processes Personio person.created events, fired when a new person is created.

EmployeesWebhooks

Person Updated`personio_webhook_person_updated`

Processes Personio person.updated events, fired when a person profile is updated.

EmployeesWebhooks

Person Deleted`personio_webhook_person_deleted`

Processes Personio person.deleted events, fired when a person is deleted.

EmployeesWebhooks

Employment Created`personio_webhook_employment_created`

Processes Personio employment.created events, fired when a new employment is created for a person.

EmploymentsWebhooks

Employment Updated`personio_webhook_employment_updated`

Processes Personio employment.updated events, fired when an employment is updated.

EmploymentsWebhooks

Employment Cost Centers Updated`personio_webhook_employment_cost_centers_updated`

Processes Personio employment.updated.cost-centers events, fired when the cost centers of an employment change.

EmploymentsWebhooks

Employment Deleted`personio_webhook_employment_deleted`

Processes Personio employment.deleted events, fired when an employment is deleted.

EmploymentsWebhooks

Employment Started`personio_webhook_employment_started`

Processes Personio employment.started events, fired when an employment reaches its start date.

EmploymentsWebhooks

Employment Terminated`personio_webhook_employment_terminated`

Processes Personio employment.terminated events, fired when an employment is terminated.

EmploymentsWebhooks

Absence Period Created`personio_webhook_absence_period_created`

Processes Personio absence-period.created events, fired when a new absence period is requested or created.

AbsencesWebhooks

Absence Period Status Updated`personio_webhook_absence_period_status_updated`

Processes Personio absence-period.updated.status events, fired when the approval status of an absence period changes.

AbsencesWebhooks

Absence Period Timerange Updated`personio_webhook_absence_period_timerange_updated`

Processes Personio absence-period.updated.timerange events, fired when the start or end of an absence period changes.

AbsencesWebhooks

Absence Period Deleted`personio_webhook_absence_period_deleted`

Processes Personio absence-period.deleted events, fired when an absence period is deleted.

AbsencesWebhooks

Attendance Period Created`personio_webhook_attendance_period_created`

Processes Personio attendance-period.created events, fired when a new attendance period is recorded.

AttendancesWebhooks

Attendance Period Updated`personio_webhook_attendance_period_updated`

Processes Personio attendance-period.updated events, fired when an attendance period is updated.

AttendancesWebhooks

Attendance Period Deleted`personio_webhook_attendance_period_deleted`

Processes Personio attendance-period.deleted events, fired when an attendance period is deleted.

AttendancesWebhooks

Document Created`personio_webhook_document_created`

Processes Personio document.created events, fired when a new document is uploaded.

DocumentsWebhooks

Document Updated`personio_webhook_document_updated`

Processes Personio document.updated events, fired when a document is updated.

DocumentsWebhooks

Document Deleted`personio_webhook_document_deleted`

Processes Personio document.deleted events, fired when a document is deleted.

DocumentsWebhooks

Document Signed`personio_webhook_document_signed`

Processes Personio document.signed events, fired when a document is signed.

DocumentsWebhooks


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.