Remote logoStudyTube logo

Training and certificates

Remote to StudyTube integration: employees from Remote in the academy, with department and manager

With an integration between Remote and StudyTube, every employee in Remote automatically gets a StudyTube account once their onboarding is done, in their department's team and with their manager as team manager. After the last working day from the offboarding in Remote the account is removed from StudyTube.

What the integration does

Organisations that employ people in several countries through Remote and use StudyTube for onboarding and mandatory training often add new colleagues to the academy by hand. Anyone who starts through another country or as a contractor easily slips through the cracks.

  1. Remote reports that an employee's onboarding is done; KoppelHet fetches the employment.
  2. The department becomes a team in StudyTube and the employee gets an account in that team, in the language of their country.
  3. KoppelHet looks up the manager by email address in StudyTube and makes them team manager.
  4. A new department or manager in Remote moves the employee in StudyTube.
  5. After the last working day from the offboarding KoppelHet removes the account.
Remote → KoppelHet → StudyTubeSOURCERemoteTARGETStudyTubeKoppelHetmapping · logging · monitoringRemote → KoppelHet → StudyTubeSOURCERemoteTARGETStudyTubeKoppelHetmapping · logging · monitoring
Out: User with name, work email, job and language per country · Teams from the departments in Remote · Team manager by the manager's email address · Licence per type of employment

What to watch for with Remote and StudyTube

  • Remote only reports a completed onboarding once all of the employee's tasks are done and their account is active. KoppelHet creates the StudyTube account at that moment, so the invitation does not reach someone who still has to sign their contract.
  • A department appears on the employment in Remote as a name and as a fixed ID. KoppelHet uses that ID as the team's external_id in StudyTube, so a renamed department stays the same team and does not create a second team next to the old one.
  • Remote only gives the manager's ID when they are also employed through Remote, and otherwise only their email address. StudyTube can resolve up to a hundred email addresses to users at once. KoppelHet therefore looks up managers by email, so a manager on the own payroll also becomes team manager.
  • Remote has EOR employees, contractors, direct employees and global payroll. Per type we agree whether StudyTube assigns a content licence, so a contractor does follow the mandatory code of conduct without a full licence.
  • An offboarding in Remote goes through steps: submitted, in review, submitted to payroll and completed, and completed only follows after the final payment. KoppelHet does not wait for that, but removes the StudyTube account on the day after the last working day.
  • Remote has a field for an external ID, but does not enforce that it is unique. KoppelHet therefore uses the Remote employment ID as uid in StudyTube, and not an employee number that someone types in by hand.
  • Every employment in Remote has a country. There is no language field, so KoppelHet derives the StudyTube language from the country, with a list we agree per organisation, for example German for Germany and English for countries whose language StudyTube does not support.

How we build and run it

  • The integration runs on the KoppelHet platform, hosted in a data centre in the EU.
  • Every sync and every error is visible in the functional log; on an error your administrator is notified.
  • A change that cannot go through is not half-applied but queued for another attempt.
  • KoppelHet is ISO 27001 certified. Data travels encrypted and stays on the platform no longer than needed.
  • After go-live we manage the integration and adjust it when your process changes.
  • The integration fits next to your existing integration layer. Only the fields in the design are transferred; the platform keeps no register of its own.

Implementation, architecture and compliance

Implementation and price

This is not an app you switch on. We build the integration for your organisation on our platform, with building blocks we reuse on every project. So it is custom work that does not start from scratch.

A consultant prepares the intake and analyses both systems. We then record the mapping and exceptions field by field, test in the test or acceptance environment and go live at a moment you choose. Costs are a one-off amount for the setup and a monthly amount for platform, monitoring and support.

Price indication · Basic

Leave your work email and you see the price indication right away.

We only use your address to follow up on your question about this integration.

Frequently asked questions

Do certificates come back to Remote?

Not in the first version. Remote has custom fields per employment that can be filled through the API; putting the latest certificate there can follow later as an extension.

Does this also work for employees on our own payroll?

Only if they are in Remote, for example as direct employee or through global payroll. Anyone who is only in another HR system comes into StudyTube through that source.

What if a webhook from Remote fails?

Then the daily comparison of Remote with StudyTube fixes the difference within a day.

Technical details for IT

For those who want to know how it works under the hood: APIs, fields and sources used.

  • Remote API with a customer API token or OAuth 2.0 and the employment:read scope: GET /v1/employments/{id} (full_name, work_email, job_title, country, department, department_id, manager_email, manager_employment_id, type, employment_model, status, user_status, employment_lifecycle_stage, external_id). Webhooks employment.onboarding.completed, employment.details.updated, employment.status.updated, offboarding.submitted and offboarding.completed.
  • StudyTube Academy API v2 with OAuth 2.0 client credentials (write scope): POST /api/v2/users on uid (language, assign_licence), GET /api/v2/users/ids with 1 to 100 email addresses, academy-teams/bulk/upsert up to 500 teams, academy-teams/managers/sync and DELETE /api/v2/users/{id}.

Which fields are transferred

The key fields. The full mapping is agreed per customer.

Field in RemoteField in StudyTubeNotes
employment iduid
full_namefirst_name en last_nameSplit according to an agreed rule
work_emailemail
job_titlecompany_role
countrylanguage
department_id en departmentTeam met external_id en naam
manager_emailTeammanager via users/ids
type (employee, contractor, direct_employee, global_payroll_employee)assign_licence ja of nee
Laatste werkdag uit de offboardingDELETE op de dag erna

Related

Which systems do you want to connect?

Tell us which systems you use and what should happen automatically. Together we define the smallest working solution, with a clear design and a quote before building.