Sese-Schneider / ha-personio

Integration with the Personio API for Home Assistant.

Personio integration by @Sese-Schneider

A Home Assistant integration with the Personio API.

Features:

• Automatically adding attendances through an added switch.

Install

HACS

This repo is available for install through the HACS.

• Go to HACS → Integrations
• Use the FAB "Explore and download repositories" to search "Personio".

or

Click here:

Setup

To use the integration, you need to have API access enabled on your Personio account. You might need to reach out to your People/HR department to request that.

1. Access your settings panel and click on "Generate new credential"
2. Specify an application identifier. You'll need that later.
3. You need to enable Read and Write Access to the "Attendances" data. Also read access to employee data is required to allow figuring out the Personio User ID based on email.
4. "Readable employee attributes" should be email.
5. You're now good to go. Install the integration in Home Assistant.
   • Enter the "Client ID" and "Client Secret" that were generated
   • "Partner identifier" can be left empty in most cases. It's only required in case you are a "partner company" of Personio.
   • "Application identifier" is the identifier you specified in step 2.