Skip to content
oneVcard Logo oneVcard Help

Documentation for connecting and setting up oneVcard Teams Enterprise with Personio

Enterprise

This article outlines the requirements and implementation of the Personio integration to automatically create and maintain user and business card data in oneVcard.

Technical requirements

A. Technical Requirements

Start by navigating to the website https://www.personio.de/login and logging in to your Personio account if you are not already logged in.

Next, navigate to the settings in the left sidebar.

Navigate to settings

Click on “API access data” within the “Integrations” section.

Navigate to API access data

Create a new integration by clicking the “Create custom integration” button.

Create custom integration

Enter a suitable name, such as “oneVcard Sync.”

Enter name

Now configure the access rights for the oneVcard Sync. It is mandatory to select the “Read” option under the “Employees” category. This is necessary for the oneVcard integration to read all required employee data.

Set access rights

Now, you can select all attributes that are important to you. All attributes you select here will be transferred to oneVcard. Attributes you do not select will not be transferred.

Select attributes

As the second-to-last step, you can select your companies, if applicable. This allows for more granular control over which employees can be transferred to oneVcard.

Selection of companies

As the final step, copy both your Client ID and your API Secret. Save them in a location where you can easily retrieve them later. The API Secret should never be shared and cannot be viewed again after completing the configuration.

Copying the access data

Click the “Complete” button to finish the process.

You have now completed the configuration in Personio.

B. oneVcard Settings

B1. Basic setup

Go to the Personio integration in your oneVcard team under the “Integrations” tab.

Integrations in the Team

Now, enter the “Client ID” from the previous step into the “Client” field and your “API Secret” into the “Client Secret” field.

You have now completed all the necessary settings. Save the settings using the icon next to the header.

B2. Determine Custom Fields

If you have not created any custom fields in Personio, you can skip this step.

To easily determine the paths to your custom fields, our oneVcard Personio Helper provides a simple solution, as Personio does not offer such functionality in the interface by default.

Download the appropriate version:

It is possible that your computer will display a security warning. If you downloaded the software directly from this page, you can trust it.
(Support for Apple devices)

Start the executable file via the terminal or command prompt (CMD). If necessary (e.g., on macOS), grant the file the required permissions using the command “chmod +x your_file”.

Follow the instructions in the oneVcard Personio Helper. After successful completion, a CSV file containing all custom fields will be created in the directory where the executable file is located.

In the next step, use the path from the column titled “Path” to create a mapping for custom fields.

B3. Create field assignment

As described here, create a field mapping in the “Field Mappings” section below.

You can now start a synchronization by clicking “Synchronize Now.” After a waiting period, the employees will be created in oneVcard.

If the setup did not work, an error will be displayed under “Last Executions.” If you need help, don’t hesitate to contact us.