Manatal is a recruitment and applicant tracking system. Once it's connected, a candidate you share from Manatal is added to Microkeeper as a new employee, and sent a welcome letter to start their onboarding.

Required plan	All plans
Required access	Settings

This guide covers how to:

Connect Manatal to Microkeeper.
Send hired candidates to Microkeeper.
Finish setting up a new employee.
Send Manatal custom fields to Microkeeper.

Before you connect Manatal

You need a Manatal account. To turn on the Manatal integration for your Microkeeper account, contact Microkeeper.
New hires go into each of your Groups set to Auto Add. Check those are the Groups new staff should start in. See Groups.

Connect Manatal to Microkeeper

In Manatal, go to Administration > Integrations, add Microkeeper, and copy your API key.
In Microkeeper, navigate to Menu > Settings > Employees, and click Connect Manatal.
Paste the key into Paste Manatal API Key.
Click Save Connection. The button then shows Manatal Connected.

The Manatal Recruitment Integration window, with marks matching the steps: 3 Paste Manatal API Key, and 4 Save Connection

Send a hired candidate to Microkeeper

In Manatal, open the job and move the candidate to the Hired pipe.
On the candidate, click the three dots, then Share > Share to HR System.
Choose Microkeeper and click Share.

A candidate in Manatal's Hired pipe, with the three dots menu open at Share and Share to HR System

To send several candidates at once, click the three dots at the top of the Hired pipe, then Select All, and Share > to HR System.

Manatal's Hired pipe menu with Select All, and the Share menu with to HR System

Before you share a candidate, check they aren't already one of your employees with the same email.

What happens when a candidate is sent

Microkeeper adds them as a new employee, and sends their welcome letter by email and SMS, if they have a valid email and Australian mobile. They log in and complete their onboarding. See Onboarding.

These details come from Manatal:

Manatal	Microkeeper
Full name	Given Name and Surname, split at the first space
Email	Email
Phone number	Mobile Number
Contact	Home Phone Number
Gender	Gender
Address	Address, City, State and Postcode, for an Australian address
Job	Position
Start date, or hired date if there's none	Start Date
Employee status that says casual, part time or full time	Employment Type

Finish setting up a new employee from Manatal

On the new employee's profile, check and set what Manatal doesn't send:

their pay cycle, pay rate and Rate Rule, under Payment & Employment;
their Employment Type, if it isn't right;
their Groups, Location and access.

See Add an Employee.

Send Manatal custom fields to Microkeeper

A Manatal custom field is copied to Microkeeper when its key matches a Microkeeper field.

Microkeeper's own fields

Manatal custom field key	Microkeeper field
dob	Date of Birth
nokname	Next of Kin Name
taxfilenumbertfn	Tax File Number
entitledannualleave	Annual Leave Entitlement

Your custom fields

Make the Manatal key your custom field's Name in lowercase with the spaces taken out. For example, "emergencycontact" fills in a custom field named Emergency Contact. See Custom Fields.

Each value must suit the field's Validation. Send dates as YYYY-MM-DD, and Yes or No answers as "yes" or "no".

Manatal troubleshooting

Why can't I see Connect Manatal?

It shows on Settings > Employees with Settings access, once Microkeeper has turned on the Manatal integration for your account. Contact Microkeeper to turn it on.

Why didn't a candidate I shared appear in Microkeeper?

Check they have a full name, and that their email doesn't already belong to one of your employees. When you share several candidates, check each one, then share them again.

Why didn't a custom field come across?

Its Manatal key must match a Microkeeper field, or your custom field's Name in lowercase with no spaces, and its value must suit the field's Validation.

Guides

Recruitment - Manatal