Skip to main content

MTP: Integrate MyTimePlan (MTP) with Journeys

Connect your MTP account via the app marketplace

Written by Helga Björg Helgadóttir

Once connected, Journeys can automatically create employees in MTP, manage employment records, and more 🚀

Step 1: Authentication 🔒

First, contact MTP and ask them for an API key for Journeys. This can take time, so please send the request before you start the rest of setup.

Once you have your API key, open Journeys, go to the app marketplace under settings, open the MyTimePlan app, and click Connect in the top right corner.

Follow the instructions on screen, i.e. input your company subdomain and paste your API key, then click Connect.

Now you've connected authentication!

Step 2: Decide which "create a user" endpoint should be used

The MTP integration includes the following three actions to create an employee:

  • Create employee via accounting id

  • Create employee via external id

  • Create employee via position id

In order to create a user, all your units in MTP need to either have a unique accounting ID, external ID, or position ID.

It is up to your company to decide which ID type to use as the unique identifier for your MTP units. For example, if you choose external id, please make sure that no two MTP units have the same external id.

How to check what IDs are currently assigned to your MTP units

  1. Log into MTP as an admin user.

  2. In MTP, click on "Stillingar" (Settings) in the top right corner.

  3. Next, in the top right corner, click "Skipurit" (Hierarchy).

  4. You will see a list of all your top-level company units. To see units that are nested inside a parent unit, you can click the chevron on the left to expand/collapse the list.

  5. Note that "Bókhaldsnúmer" is the unit's accounting id and "Ytra auðkenni" is the unit's external id. If a unit doesn't have any ID, we cannot automatically add an employee to it.

  6. To see the position ID of a unit, or to change an ID, click the unit name in the list to open the unit's settings page.

  7. From the unit's settings page, locate and click on "Accounting". You might have to scroll down to find it.

  8. You will see fields called Accounting Id, External Unit Id, and Position Ids. Here, you can see the IDs currently assigned to the unit and change the IDs if needed.

  9. When done, click Vista (Save) to save any changes made to the IDs.

  10. Repeat this process for every unit that is either missing an ID, does not have a unique ID, or has the incorrect ID according to how your company prefers to identify units.

Once you have completed this ID setup, you are ready to add MTP actions to your journeys 🚀

Step 3: How to use the actions in a journey

Create an employee in MTP

To create a new employee in MTP, you will need the following three actions in your journey in this exact order:

  1. Create employee via accounting/external/position id (one of these three)

  2. Add employee contract (is: Bæta við samning)

  3. Add employment (is: Bæta við vinnuskyldu)

Also make sure you have enabled "Velkomin til starfa" email notifications in MTP. Those emails contain the password for the new employee to be able to sign in.

Related Articles
Did this answer your question?