Follow this guide to set up an integration with MyTimePlan (MTP) in Journeys 🚀

Step 1: Authentication 🔒

First, contact MTP and ask them for an API key for Journeys.

Once you have your API key, open Journeys, go to the integration list, and open the MTP integration template. If it's missing, please ask the 50skills team to copy it to your account.

Next, click Authenticate to open the authentication sidebar.

In the authentication sidebar, fill in the following fields:

Authentication type: API key

Header key: X-Auth-Token

API key: your API key from MTP

Then click Save in the bottom right corner.

Now you've connected authentication!

Step 2: MTP setup checklist 📋

Before you can start using the MTP integration, you'll need to configure the following three things:

1. Change the endpoint base URL

The MTP integration template has the base URL set as https://mtpintegration.mytimeplan.com/API/v1/ by default. You will need to replace mtpintegration with your own company's subdomain.

You can do this by clicking the three dots to the right of the MTP integration, and clicking Edit.

In the Edit Integration sidebar, replace "mtpintegration" with your subdomain, then save your changes.

2. Make sure the endpoints work

To make sure the authentication has been correctly set up, you can test-run any GET endpoint (for example "Sækja allar fyrirtækjaeiningar", which fetches all company units).

💡 Side note: Make sure the endpoint URL contains your subdomain before testing

If the test response is successful, the authentication is connected! 🎉

3. Decide which "create a user" endpoint should be used

The MTP integration template will include the following three endpoints to create a user in MTP:

Add employee based on accounting id
Add employee based on external id
Add employee based on 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 can I check what IDs are currently assigned to my MTP units?

Log into MTP as an admin user.
In MTP, click on "Stillingar" (Settings) in the top right corner.
Next, in the top right corner, click "Skipurit" (Hierarchy).
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.
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.
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.
From the unit's settings page, locate and click on "Accounting". You might have to scroll down to find it.
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.
When done, click Vista (Save) to save any changes made to the IDs.
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 these three steps, you are ready to add MTP integration actions to your journeys 🚀

Step 3: Adding MTP integration actions to a journey

The MTP integration template contains various useful endpoints to automate your HR processes.

Create a user in MTP

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

Bæta starfsmanni við út frá accounting/external/position id (one of these three)
Gefa starfsmanni samning
Gefa starfsmanni vinnuskyldu

All three actions are included in the MTP integration template and must be added to the journey in this order.

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.

Change work percentage

Use the "Breyta starfshlutfalli" action from your MTP integration template to update an existing employee's work percentage after the employee has already been created in MTP.