Skip to main content

Using the Moorepay integration

Send candidate and new hire data straight to Moorepay (formerly NaturalHR) with no manual re-entry required

Written by Lia Bartosz

The NaturalHR integration lets you send candidates from Pinpoint (both Recruitment and Onboarding) straight into Moorepay (formerly NaturalHR).

It creates their employee record, attaches their documents, and can set up their holiday allowance, so nobody retypes information.

✅ Permissions

You need the Export applications to external HRIS permission to send candidates and view exported data (including sensitive data).

🔒 Availability

This integration is switched on by Pinpoint. To get started, reach out to your Customer Success Manager (CSM).


Configuring the integration

To configure the integration:

  1. Create an API key in Moorepay.
    Give it Read, Create, and Update access.

  2. Copy the API key to clipboard.

  3. Expand Settings in Pinpoint.

  4. Select Integrations.

  5. Go to the My Plugins tab.

  6. Click NaturalHR.
    ​

  7. Paste the key into the NaturalHR API Key field.

  8. Click Save.

✅ Tip

Ask your CSM for help with data mapping. Together, you'll decide where each Moorepay field gets its value in Pinpoint, including which documents to send by default and which custom fields to use in Moorepay.


Sending a candidate to Moorepay

To send a candidate to Moorepay:

  1. Go to the candidate's application/Onboarding profile.

  2. Open the three-dot menu (⋯).

  3. Select Send to NaturalHR.
    This will open a pre-filled form.
    ​

  4. Check the mapped data.
    This includes any documents set up in your data mapping, such as CVs.

  5. Fill in any fields that are missing.

  6. Click Add document to attach additional files.
    Documents are grouped by where they come from to make them easier to find.
    ​

  7. Click Submit.

Moorepay creates the employee record at this point. If they are switched on for your account, it also:

  • creates a Moorepay login

  • adds the holiday allowance

  • attaches the documents

Possible outcomes

You'll see one of three possible outcomes:

  • Full success - The employee is created, and everything else you asked for (holiday allowance, user account, documents) is done too.

  • Partial success - The employee is created, but one of the extra steps didn't go through. The message tells you which one (for documents, which files), so you can add it in manually in Moorepay.

  • Failure - The employee wasn't created, so nothing was sent. The message shows what Moorepay needs you to fix.


Mapping data relationships

Custom fields

If you record extra information about employees in Moorepay using custom fields (for example, a payroll frequency or a cost code), those fields can appear at the end of the Send to NaturalHR form.

Each one will be pre-filled from your data mapping and can be made mandatory, so the export can't be sent without it.

Field mapping

Each field on the form gets its value in one of three ways:

  • from your data mapping (for example the candidate's name, email, address and start date)

  • from a dropdown of values in your Moorepay account

  • typed in by the recruiter.

You can change the mapping at any time by contacting your CSM. The form can be set up to show just the fields you use, in the order and with the names that match how your team works.


Sending and receiving data

Data sent to Moorepay

When sending data from Pinpoint to Moorepay, these fields are required:

  • First Name

  • Last Name

  • Email

  • Date of Birth

  • National Insurance Number

  • Job Update Date

  • FTE

  • Active

  • Salary Date

  • Allowances Date

  • Holiday Allowance (if enabled)

  • User Account (if enabled)

  • Custom fields (if enabled)

Each export creates the employee record first. The user account, documents, and holiday allowance follow (if they are switched on and filled in).

ℹ️ Note

National Insurance Numbers must be unique.

Data read by Pinpoint

The dropdowns on the form show the live values from your Moorepay account. A value you've just added in Moorepay can take up to an hour to appear in Pinpoint.

Changes made in Moorepay after candidate data is initially sent don't come back to Pinpoint.

If you try to send the candidate again, Pinpoint first shows the earlier sends, with who sent them and when, before you start a new one.


Troubleshooting

I'm getting an "API Key Error" when the form opens.

The NaturalHR API key is missing or no longer valid. Create a new API key in Moorepay and update it in Pinpoint.

I'm getting an "Your read-only API key is not valid" error.

The optional read-only key is incorrect. Update or clear NaturalHR Read Only API Key in Pinpoint plugin integration settings.

One of the dropdowns on the form is empty.

Check the API key has read access in Moorepay, then reopen the form. If it's still empty, contact our Support team.

I'm getting an "The national insurance number must be unique" error.

This means that the candidate already has an employee record in Moorepay. Check that system before sending again.

A date is getting rejected.

Enter it in a YYYY-MM-DD format, for example 2026-11-30.

I'm getting an "Employee created, but ... failed" error.

The employee record was created, but the optional feature(s) was not. Add the missing user account or holiday allowance manually in Moorepay.

I'm getting an "Some documents were not uploaded" error.

Sending the candidate to Moorepay partially failed. Their employee record and other documents will have been sent, but you'll need to re-upload the listed files in Moorepay.


Frequently Asked Questions

Can new starters be sent to Moorepay automatically?

Yes. The step to send candidates to Moorepay can run as a stage action, so moving a candidate to a stage (for example Hired) sends them using your data mapping, including the mapped documents.

We recommend sending by hand for a few weeks first, depending on your hiring volume, and switching the stage action on once the process is running smoothly.

Reach out to your CSM for help with setting it up!

Which documents can I send?

Any document on the candidate in Pinpoint - their CV, application documents, files uploaded in answer to application questions, offer documents. For candidates in Onboarding, their onboarding documents.

Did this answer your question?