Skip to main content

Nest Pension Integration (UK)

Connect Workforce to Nest to enrol employees, send pension contributions and sync opt-outs from your pay runs.


What the Nest integration does

Workforce connects to your Nest employer account and:

  • enrols employees with Nest

  • sends pension contributions from each posted pay run, and approves the payment in Nest

  • brings opt-outs back from Nest when a pay run is posted

It’s also called the Nest connection or Nest API integration.

📝 What it doesn’t do: Workforce doesn’t create your Nest scheme, groups or payment sources. You set those up in Nest. Workforce reads them from Nest.

If you use a different pension provider, set it up as a Custom pension provider and send contributions yourself (for example with a PAPDIS file). See PAPDIS Pension Export (UK).


Before you connect Nest

Make sure you have:

  • Pay groups set up, with the correct pay frequency (weekly, fortnightly, four-weekly or monthly)

  • Company files set up, with each employee in the correct one

  • In Nest: your groups and payment sources set up, with schedules that match your pay frequencies

  • A Nest login (username and password) that can manage your employer account. If an accountant or previous payroll provider managed Nest, ask them to give you access.

  • Your Nest employer number


How do I connect Nest?

  1. Go to Payroll > Payroll Settings > Pension Providers.

  2. Click + New.

  3. In Pension Provider System, select Nest.

  4. If you have more than one company file, select the Company File this Nest account is for.

  5. Enter your Nest Username and Nest Password.

  6. Enter your Employer Number without “EMP”. For example, for EMP00123456 enter 00123456.

  7. Under Contribution Settings, enter the default employee and employer contributions. Employees use these unless you set a custom amount for them.

  8. Open Advanced Settings if needed:

    • Calculation Method and Contribution Method

    • Enable automatic pension assessment: Workforce assesses employees each pay run and auto-enrols eligible jobholders.

    • Enable employee communications?: Workforce emails employees their pension letters. See Pension Communications.

  9. Click Create.

⚠️ Error: “‘EMP’ should be removed from your Nest employer number.” Remove “EMP” from the start and save again.


What happens after I connect Nest? (setup sync)

When you click Create, Workforce connects to Nest and downloads your groups and payment sources. This is called the setup sync. It runs again when you change the employer number, username or password.

  • It can take a few minutes, depending on Nest.

  • When it’s done, your Nest groups and payment sources appear as options on each employee’s Pension tab.

  • The setup sync does not send any employees to Nest.

If you add or rename a group or payment source in Nest: go to Payroll > Payroll Settings > Pension Providers and click Re-Sync Nest Setup.

If you see “last setup sync failed”: check the Nest username, password and employer number, then click Re-Sync Nest Setup.


How do I set up an employee for Nest?

Open the employee’s profile and go to the Pension tab. Set:

Field

What to enter

Pension provider

Your Nest provider

Member number

Their existing Nest member number if they’re already in Nest. For a new member, a unique reference such as their payroll ID. Required.

Group name

The Nest group they belong to (from the setup sync)

Payment source

The Nest payment source (from the setup sync)

Contributions

Leave as the scheme default, or set a custom amount

Enrolment status / postponement

If they’re already enrolled, or you’re postponing

The employee also needs a date of birth and a valid NI number (or to be marked as not having one).

⚠️ Group and pay frequency must match. If a group runs on a monthly schedule in Nest but the employee is paid weekly, you’ll see a warning. Nest will likely reject their contributions. Pick a group with the right schedule, or change the group’s schedule in Nest.

Example: a monthly pay group needs a monthly Nest group. A four-weekly pay group needs a four-weekly Nest group.


How does Nest know which employee is which? (member number)

Nest uses the member number to identify each employee. Workforce also sends their name, NI number, date of birth, address and email.

  • Already in Nest? Use the same member number Nest already has. If it’s different, Nest may create a duplicate member.

  • New to Nest? Use a unique reference that won’t change, such as their payroll ID.

📝 Workforce does not match employees by NI number or name. The member number is what links them.


How are employees enrolled with Nest?

There are three ways.

1. Automatic enrolment (in a pay run)

To enable automatic pension assessment:

  1. Go to Payroll > Payroll Settings > Pension Providers.

  2. Open (edit) the Nest provider.

  3. Expand Advanced Settings.

  4. Tick or untick Enable automatic pension assessment.

  5. Click Update.

If Enable automatic pension assessment is on, Workforce assesses employees in each pay run. When an employee becomes an eligible jobholder, Workforce enrols them and sends them to Nest, as long as they:

  • have a member number

  • haven’t opted out

  • aren’t postponed

⚠️ No member number means no automatic enrolment. If an eligible employee has no member number, they won’t be enrolled. Add one, and they’ll be enrolled in the next pay run, or enrol them yourself (option 2).

2. Enrol one employee yourself

  1. Open the employee’s profile > Pension tab.

  2. In the Nest panel, click Enrol with Nest. If they’re already enrolled in Workforce but weren’t sent, click Send to Nest.

If the button isn’t there, the panel lists what’s missing, for example “No Nest member number”, “No Nest group set” or a date of birth that isn’t set.

3. Enrol in bulk


Import pension memberships by CSV. See Pension CSV Imports & Bulk Enrolment.

📝 State Pension age: Nest won’t accept an automatic enrolment for someone who has reached State Pension age.

Postponement: if you’ve postponed an employee, Workforce doesn’t enrol them until the postponement ends. They’re then reassessed in the next pay run. If they’re eligible and have a member number, they’re enrolled from the end of the postponement (the deferral date). You don’t need to do anything.


What does the Nest status on an employee’s Pension tab mean?

Message

What it means

What to do

Not enrolled with Nest yet

They’re an eligible jobholder but haven’t been enrolled

Click Enrol with Nest

Not sent to Nest yet

Enrolled in Workforce, but not sent to Nest

Click Send to Nest

Sending enrolment to Nest

Sent, waiting for Nest

Check back in a few minutes

Nest hasn’t confirmed the enrolment

Sent, but no reply from Nest

Click Retry enrolment. Nest won’t enrol them twice.

Enrolment with Nest failed

Nest rejected it

Fix the errors shown, then click Retry enrolment

Failed enrolments also show on the payroll dashboard as Failed NEST enrolments.


How do I send pension contributions to Nest?

Contributions are not sent automatically. You send them after you post the pay run.

  1. Post the pay run.

  2. On the posted pay run, find the Pay pension contributions step.

  3. Click Send Contributions to Nest.

  4. Check the pop-up:

    • “This will send contributions to Nest for X staff.”

    • Choose a reason for £0 contributions: for anyone with a £0 contribution this period, pick a reason (for example Member is on family leave or Member has insufficient earnings). Nest needs a reason for each one.

    • Some employees won’t be sent: these have a Nest setup problem, such as no group or payment source. Click their name to fix it, then click Recheck, or send the rest now and send these later.

  5. Click Send Contributions to Nest.

What happens next: once Nest accepts the contributions, Workforce automatically approves the payment in Nest. The step then shows one of these:

Status

Meaning

Send contributions to NEST

Not sent yet

Contributions sent to NEST, waiting for the payment to be approved

Nest accepted them, and the payment approval is in progress

Contributions sent to NEST and payment approved

✅ Done

NEST rejected some contributions… / Sending contributions to NEST failed… / Approving the NEST payment failed…

Check View Logs (below), fix it and send again

Who isn’t sent: employees who have opted out, are postponed or aren’t enrolled.

The same dropdown also has Pension Contribution Report and Generate PAPDIS.

Posted pay runs with unsent contributions show on the payroll dashboard as NEST contributions not sent.


How do opt-outs from Nest work?

Employees opt out with Nest, not in Workforce. Each time you post a pay run, Workforce checks Nest for opt-outs and updates those employees’ pension status.

You can see them in View Logs > Opted Out Staff.


Can I connect more than one company file to Nest?

Yes. Create a separate Nest pension provider for each company file:

  1. Payroll > Payroll Settings > Pension Providers > + New

  2. Select Nest, pick the Company File, and enter that company’s Nest login and employer number.

  3. Click Create.

Employees can only be enrolled with the Nest provider for their own company file. Otherwise you’ll see: “This pension provider belongs to a different company file to this employee, so they can’t be enrolled with it.”

📝 If you only have one company file, the Company File option doesn’t appear, and the provider covers everyone.


Where can I see what was sent to Nest? (Nest Requests / View Logs)

  1. Go to Payroll > Payroll Settings > Pension Providers.

  2. Next to your Nest provider, click View Logs.

The Nest Requests page has four tabs:

  • Enrolled Staff: enrolments sent to Nest

  • Sent Contributions: contributions, by pay run

  • Approved Payments: payment approvals

  • Opted Out Staff: opt-outs brought back from Nest

You can see each request’s status and Nest’s error messages, and retry failed requests.

📝 If a failed contribution request includes £0 contributions, you can’t retry it here. Send it again from the pay run, so you can choose the £0 reasons.

Requests can take a few minutes, depending on Nest. If one isn’t there yet, check back shortly. For help with errors, see Pension Troubleshooting.


FAQs

Why wasn’t my employee auto-enrolled with Nest?

Check they have a member number, aren’t postponed or opted out, are an eligible jobholder, and that Enable automatic pension assessment is on. Then check the Nest panel on their Pension tab for anything missing.

Why can’t I see my Nest groups or payment sources?

The setup sync may still be running, or it may have failed. It runs in the background and can take a few minutes, depending on Nest.

  • Just connected or re-synced? Wait a few minutes, then refresh the page.

  • Still not showing? Go to Payroll > Payroll Settings > Pension Providers. If you see a “last setup sync failed” warning, read the error, check the Nest username, password and employer number, then click Re-Sync Nest Setup.

Will connecting Nest enrol all my staff straight away?

No. Connecting only downloads your groups and payment sources. Staff are sent to Nest when they’re enrolled.

Does Workforce send contributions automatically?

No. Click Send Contributions to Nest on the posted pay run. The payment approval in Nest is then automatic.

Nest has created a duplicate member. Why?

The member number in Workforce didn’t match the one Nest already had for that person. Update the member number to match Nest, and contact Nest to remove the duplicate.

Why is Nest rejecting an employee’s contributions?

Usually their group’s schedule doesn’t match their pay frequency, or the group or payment source no longer exists in Nest. Check the warning on their Pension tab and the errors in View Logs.

Does Nest send its own letters to employees?

Check with Nest. If you want Workforce to email pension letters, turn on Pension Communications.


Did this answer your question?