All Collections
Quick start for admins
Integrations (API)
Learn how to import, update and delete roles via an integration
Learn how to import, update and delete roles via an integration
Paul Kuijf avatar
Written by Paul Kuijf
Updated over a week ago

The following articles may also be interesting for you:


Import roles

Manually

Go to Career - Job library and press Options - Import roles. This retrieves roles that are in the personnel administration system, but not yet in Learned. As soon as you press Confirm the roles are added to Learned.

Note: Only the names of the roles are imported. The employees associated with this role are synchronised via the Employee synchronisation API.

Automatically

After you have done a manual synchronisation of the roles and are sure that the integration is working properly, you can set the synchronisation to 'automatic'. New roles in your personnel administration system are automatically added to Learned every day. The automatic synchronisation occurs once a day and is set to (UTC +0) 22:00 for teams, 22:20 for roles and 22:40 for users.

Synchronising roles

Manually

Go to Career - Job library and press Options -> Synchronise roles. Retrieves roles that have been renamed in the personnel administration system but not yet modified in Learned. As soon as you press Confirm, the names of the roles will be changed.

Automatically

After you have done a manual synchronisation of the roles and are sure that the integration works properly, you can set the synchronisation to 'Automatic'. Name changes in your personnel administration system are automatically processed in Learned. The automatic synchronisation occurs once a day and is set to (UTC +0) 22:00 for teams, 22:20 for roles and 22:40 for users.

Deleting roles

Manually

Go to Career - Job library and press Options - Clean up roles. This will mark roles that have been deleted in your HR system but still exist in Learned for removal. As soon as you press Confirm, the roles are also removed from Learned. Only the role profiles are deleted. The accounts of the employees associated with the roles are not deleted.

Automatically

After you have done a manual cleanup of the roles and are sure that the integration is working properly, you can set the cleanup to 'Automatic'. Roles that you remove in your personnel administration system are automatically removed from Learned. The automatic synchronisation occurs once a day and is set to (UTC +0) 22:00 for teams, 22:20 for roles and 22:40 for users. Only the role profiles are deleted. The accounts of the employees associated with the roles are not deleted.

FAQ

Do manually created roles also sync with the API?

No manually created roles in Learned are not connected to your API. You can tell by the label "manual". You can delete the manually created role and then re-import the role from the integration. The role is then set to "Integration" and will be synchronised.

I can't import a role because it already exists?

If a role with the same name already exists in Learned, it cannot be imported. Please delete the manually created role and try again.

Did this answer your question?