Skip to main content

YouServe integration

Learn how the Alleo / YouServe integration works and how to set it up

Written by Sven
Updated over a week ago

By setting up the integration between YouServe (Visma) and Alleo, you achieve the following:

  • All existing employees in YouServe are added to Alleo

  • Any changes in YouServe (employees joining or leaving) are automatically synchronised with Alleo on a daily basis

πŸ“Œ Through this integration, Alleo receives 'Read-Only' access to YouServe β€” we can never modify data in YouServe.


Steps to set up the integration

  1. Create an account on the YouServe Developer Portal at developers.youserve.nl. Registration is free and only requires a business email address and company address.

  2. Submit a support ticket to YouServe to create an API application on your account. The API key will then appear under 'Your Apps' in the Developer Portal.

  3. Generate a private/public key pair. Send the public key to YouServe for registration. The private key is used locally to generate a JWT token.

  4. Share the API key (client_id) and tenant information with your Alleo contact.

  5. Alleo will generate a test export of the data and share it with you for review.

  6. Once you confirm that the employee data is correct, the integration can be activated.


What data is exchanged after setting up the integration with YouServe?

The following fields are retrieved via the YouServe API:

Employee (employee object)

YouServe field

Alleo field

id

external_id

emailAddresses[] – type personal

private email

emailAddresses[] – type business

email

knownAs

first name

lastName

last name

dateOfBirth

birthday

isActive

enrollment status

Employment (employments[])

YouServe field

Alleo field

contractId

employment external_id

employeeCode

payroll ID

employmentType

employment type

hireDate

start_date

originalHireDate

work anniversary (original start date)

dischargeDate / endDate

offboarding date

Company (/iam/v1.0/companies)

YouServe field

Alleo field

id

company external_id

shortName

company short name

fullName

company full name

πŸ“Œ Note: YouServe does not have a clear prefix separation. The prefix field is therefore left empty in Alleo.

Did this answer your question?