Back to integrations
    NMBRS logo

    NMBRS

    Payroll

    Sync payroll data and push worked hours to NMBRS — no manual re-entry.

    Who can use this: business owners and account admins. The NMBRS settings are only visible to those roles.

    What the integration does

    DirectionWhat movesTrigger
    Pull from NMBRSEmployees, contract hours, hourly wage, leave requests, leave balancesYou click Sync Now
    Push to NMBRSWorked hours (from time entries), approved leaveYou click Push to NMBRS / approve leave
    Everything is manual / on-demand — nothing runs on a schedule and there are no webhooks. You stay in control of when data moves.

    How to install

    1. 1Go to Settings → Integrations → NMBRS.
    2. 2Click Connect NMBRS.
    3. 3You'll be redirected to the NMBRS login/consent screen. Sign in and approve the requested permissions.
    4. 4If your account has more than one company, pick the company to connect.
    5. 5You'll land back in Simple Planning with the connection marked Connected.

    Permissions we request

    We request only the scopes the integration actually uses:

    ScopeWhy it's needed
    offline_accessKeep the connection alive (token refresh)
    company.info.readList and select your company
    company.payrollsettings.readRead hour codes (needed to push hours)
    employee.info.readSync employee names and contact details
    employee.employment.readRead contract hours
    employee.paymentRead hourly wage and write worked hours to payroll
    employee.leaveRead leave requests/balances and write approved leave

    Linking staff to NMBRS employees

    The first time you sync, Simple Planning matches your existing staff to NMBRS employees so you don't get duplicates.

    1. 1Click Sync Now.
    2. 2A review dialog opens listing each NMBRS employee. For each one, choose: Link to existing, Create new, or Skip.
    3. 3Click Confirm & sync.
    A staff member can be linked to only one NMBRS employee. If you pick the same person for two rows, the dialog flags it and won't let you continue until it's fixed.

    Using it

    Syncing employee data

    Click Sync Now any time to pull the latest from NMBRS. Each sync updates name & phone, contract hours, hourly wage, leave requests, and leave balances.

    Pushing hours to NMBRS

    From Checkouts → Payroll, select the pay period, review the hours (only linked staff are included), and click Push to NMBRS. Hours are posted as variable hours for the matching payroll period.

    Troubleshooting

    "Push failed — Invalid_HourComponent"

    The integration couldn't read your NMBRS hour codes — usually a missing company.payrollsettings.read permission. Disconnect NMBRS, reconnect, approve the consent screen again, then retry the push.

    "Push failed — Parameter_Missing / periodDetails.period"

    A payroll period formatting issue. The app may be running an outdated version — contact support so the fix can be deployed.

    "NMBRS not connected"

    The connection expired or was removed. Go to Settings → Integrations → NMBRS and reconnect.

    A staff member's hours aren't being pushed

    They're probably not linked to an NMBRS employee. Run Sync Now and link them in the review dialog, then push again.

    Nothing appears in the sync review dialog

    There's no active NMBRS connection, or the connected company has no employees. Reconnect and confirm you selected the right company.

    Frequently asked questions

    Need help?

    If a push or sync keeps failing after the steps above, contact support@simpleplanning.works with the exact error message shown, the pay period you were pushing, and roughly when it happened, so we can trace it quickly.