Skip to main content

Nmbrs

Adding users to your academy from Nmbrs

Written by Floor Takman

Nmbrs is an integrated HR and payroll software solution for payroll administration, leave registration, and personnel management.

What does the Nmbrs integration involve?

Through the integration between Nmbrs and Rakoo, users are automatically added and updated in Rakoo from Nmbrs.

Obtaining the required information from Nmbrs

The integration between Nmbrs and Rakoo requires certain information in order to work, namely the OAuth2 Client ID, OAuth2 Client Secret, RefreshToken, and SubscriptionKey. You retrieve these from Nmbrs. Follow the steps below.

Steps to obtain the Client ID, Client Secret & RefreshToken

  • Go to the integration page on the partner portal.

  • Go to secrets and generate a secret. Save the client id and client secret you receive.

  • Use the 'helper' with the required scopes:

    • offline_access

    • employee.employment.read

    • employee.info.read

    • employee.payrollsettings.read

    • company.info.read

  • Set the redirect URL to localhost:8080 (select from the dropdown).

  • Copy the URL and paste it into your browser's address bar.

  • Grant consent for the scopes you just configured (OAuth2 flow).

  • You will be redirected to localhost:8080 with a query parameter named 'code'. Copy this value (including the '-1' at the end) — this is your Authorization code.

  • Now make the following curl request:

    • Replace values such as '<CLIENT_ID>' with the id and secret you obtained earlier.

    • You then retrieve the RefreshToken from the URL.

Steps to create a SubscriptionKey:

How do I connect Nmbrs to Rakoo?

  1. In the menu on the left, go to 'Integrations'.

  2. Under 'Automate', select 'Nmbrs'.

  3. Click 'Install integration'.

  4. Fill in the requested information.

    • Name: give your integration a name.

    • BaseUrl: https://api.nmbrsapp.com

    • TokenUrl: https://identityservice.nmbrs.com/connect/token

    • OAuth2 Client ID: obtained from Nmbrs as described above.

    • OAuth2 Client Secret: obtained from Nmbrs as described above.

    • RefreshToken: obtained from Nmbrs as described above.

    • SubscriptionKey: obtained from Nmbrs as described above.

    • JsonMapping: you discuss the mapping of the Nmbrs fields to the Rakoo fields with your Customer Success Manager. We'll share this mapping with you, and you add it here.

  5. Set the integration to 'Activated' and save the changes.

Did this answer your question?