In this article, you will learn how to integrate RYDES in Personio. You will get an overview of all the requirements, and the instructions for installing the integration with the Personio employee data API.

Activate from the Marketplace: We have improved the activation flow for this Integration. You can now start the activation from the Marketplace. For more information, visit our article Activate Integrations from the Marketplace.


What is RYDES?

RYDES is a mobility budget platform that helps companies offer their employees access to flexible and sustainable modes of urban transport by allocating individual mobility budgets that cover their transport needs.

RYDES offers all modes of mobility for leisure, office, and business trips that are 100% carbon neutral and, in a tax optimized way, helping to ensure that companies get maximum value from the platform.

Some of the advantages of using RYDES for HR teams are listed below:

  • Increases employer attractiveness and helps retain talent
  • Unified dashboard to monitor and track budgets
  • Saves admin time and resources
  • Seamlessly integrates with HR software
  • Flexible contract durations
  • General Data Protection Regulation (GDPR) compliant


How can I set up the integration of RYDES and Personio?

To set up the integration contact us to create your RYDES account. Then follow these steps:

Create custom attributes

Log in to your Personio account and create the necessary attributes in the employee information section:

RYDES Status (Attribute type = List of options) with the following six options:

  • New
  • Active
  • Paused
  • Hard Pause
  • Leave
  • Deactivated

Mobility Budget (Attribute type = Number up to two decimal places).

For more information on creating custom attributes, have a look at our Help Center article on Creating Custom Sections and Attributes.


Create API credentials

Using the RYDES template you will automatically open all the necessary fields. If you prefer to do it manually, make sure to grant read and write permission next to Employees for the following attributes:

  • First name
  • Last name
  • Email
  • Status
  • Hire date
  • Employee ID
  • IBAN
  • RYDES Status
  • Mobility Budget

Keep your Client ID and Secret at hand as you will need these to complete the next step.


Complete the setup in RYDES

  1. Login to your RYDES dashboard, go to Settings and to the bottom part Integration Settings.
  2. Click Edit, enable the Personio integration toggle and input your ClientID and Secret you got from Personio and click on Save.
  3. The system will check if the credentials work and the fields above are correctly set. If everything is fine it will save and bring you back to the Settings screen.

Your setup is complete. Now go back to Personio and set the mobilty budget amount for all employees you want to offer RYDES mobility budget to. Everything else will be taken care by the integration, which means those employees will be created in RYDES, assigned the mobility budget, and send the activation email to start enjoying the benefit.


What data will be transferred?

Data transmitted from Personio only Data transmitted in both directions Data transmitted to Personio only Employee master data transfer
EmployeeID Rydes Status   idCode
First name Mobility Budget   firstName
Last name     lastName
Status     personioStatus
Email     email
IBAN     rydesStatus
Hire Date     mobilityBudget


What are the costs?

RYDES has packages for specific company needs

Detailed information about Ryde's prices can be found here.


Who do I contact at RYDES?

If you have any further questions regarding your RYDES / Personio integration, feel free to contact Martin Miodownik from RYDES at martin@rydes.com.



Article is closed for comments.

    Topics of this article