Skip to main content
A Nmbrs developer account is required to register an integration. Sign up at the Nmbrs Payroll Developer Portal — signup is self-serve and free.

​
Register an OAuth integration

Register an application in the Nmbrs Payroll Developer Portal to obtain the Client ID and Client Secret that StackOne uses to authorize users.

1

Sign in to Nmbrs

Sign in to your Nmbrs Payroll Developer Portal account.

  • Select Sign In in the top navigation.
Nmbrs Payroll Developer Portal home page with the Sign In link in the top navigation.
2

Open My Integrations

Select My Integrations in the top navigation to see the applications registered under your account.

Nmbrs Payroll Developer Portal navigation with My Integrations selected.
3

Create a new application

On the MY INTEGRATIONS page, select Add Application.

  • Existing applications are listed with their Name, Client ID and Status.
My Integrations page listing existing applications with the Add Application button.
4

Fill in the application details

On the Details tab, complete the required fields, then select Submit.

  • App name — a name to identify the app, for example StackOne Integration.
  • App description — a brief description about the app.
  • Application type — select Web.
  • Icon URL — a public image URL, shown together with the App name.
  • Redirect URLs — enter the Callback URL from your Connector Profile. It must match exactly, because the OAuth flow rejects redirect URIs that are not registered. Use + to add more than one.
  • Privacy policy URL — a link to your privacy policy.
  • Terms of service URL — a link to your terms of service.
  • Client ID is filled in by Nmbrs and follows the format PartnerApp_{App name}_UUID.
Add Application form showing the App name, App description, Icon URL, Redirect URLs, Privacy policy URL and Terms of service URL fields.
5

Copy the Client ID and generate the Client Secret

Open the Secrets tab. Copy the Client ID value, then select Generate Secret to create a Client Secret. Generated secrets are listed under Active secrets.

  • Paste the Client ID into the Client ID field in the StackOne Connector profile.
  • Paste the generated secret into the Client Secret field in the StackOne Connector profile.
  • The Client Secret is only displayed once and cannot be retrieved later — store it securely for use later.
  • Generating a new secret for an application that is already connected invalidates the existing integration.
Secrets tab of an integration showing the Client ID field, the Generate Secret button and the Active secrets list.

​
Find your Subscription Key

Your Subscription Key authorizes calls to the Nmbrs API gateway and is sent on every request. You obtain it by subscribing to an Nmbrs API product in the developer portal.

1

Choose an API product

Sign in to your Nmbrs Payroll Developer Portal account and select Products in the top navigation.

  • Development / Starter — gives immediate access to the Nmbrs REST API, with no approval needed.
  • Private — for organizations that have built an integration for internal use within their organization.
  • Verified Partners — allows 1000 calls/minute up to a maximum of 500000 calls/month, after a functional demo of the integration.
Products page listing the Development / Starter, Private and Verified Partners subscriptions.
2

Subscribe to the product

Select the product you chose, for example Development / Starter, to open its page.

  • Enter a name in the Your new product subscription name field.
  • Select the I agree to the Terms of Use checkbox.
  • Select Subscribe.
Development / Starter product page showing the subscription name field, the I agree to the Terms of Use checkbox and the Subscribe button.
3

Copy a subscription key

Select Profile in the top navigation. Under Subscriptions, find the subscription you created and copy its Primary key or Secondary key. Either key works.

  • Use the row’s actions menu to reveal and copy the key.
  • Paste it into the Subscription Key field in the StackOne Connector profile.
  • State must be Active for the key to authorize API calls.
  • Store the key securely — it grants access to your Nmbrs API gateway quota.
User profile page showing the Subscriptions table with the Primary key and Secondary key columns.

​
Available OAuth scopes

Nmbrs scopes are requested when a user authorizes the connection, not saved on the integration. The Identity Scope selector on your integration’s Helper tab only builds the Example Request URL shown next to it, so you don’t need to change it. Select the scopes your StackOne connection should request. Always include offline_access so the connection can be kept alive past the 1-hour access-token expiry.

1

Select the scopes you need

Enables actions: Create Contract, Create Employee, Create Employee Absence, Create Employee Address, Create Employee Bank Account, Create Employee Fixed Hours, Create Employee Fixed Wage Component, Create Employee Salary, Create Employee Variable Hours, Create Employee Variable Wage Component, Create Employment, Create Leave Request, Delete Leave Request, Get Company Current Period, Get Debtor Info, Get Document Content, Get Employee, Get Employee Payslip, Get Salary Table Content, Get Salary Table Versions, Get User Info, List Absences History, List Accountant Contacts, List Companies, List Companies By Debtor, List Company Contact Persons, List Company Cost Centers, List Company Cost Units, List Company Default Templates, List Company Fixed Wage Components, List Company Hour Codes, List Company Payroll Runs, List Company Salary Tables, List Company Variable Wage Components, List Contracts History, List Cost Per Hour, List Countries, List Debtor Tags, List Debtors, List Departments, List Employee Addresses History, List Employee Bank Accounts History, List Employee Document Types, List Employee Fixed Hours, List Employee Fixed Wage Components, List Employee Variable Hours, List Employee Variable Wage Components, List Employees, List Employees Personal Info History, List Employees User Accounts, List Employments History, List End Contract Reasons, List Functions, List Leave Balances, List Leave Groups, List Leave Requests History, List Managers, List Parental Leave History, List Payroll Run Employees, List Salaries History, Update Contract, Update Employee Bank Account, Update Employee Cost Center, Update Employee Department, Update Employee Function, Update Employee Manager, Update Employee Personal Info, Update Employee Social Security Number, Update Employment, Upload Employee Document

Each scope corresponds to a group of Nmbrs actions. The selection below covers every action shipped in this connector.

​
Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for Nmbrs:
1

Open the connector

Log in to StackOne, open Connectors, and select Nmbrs.
2

Choose actions and events

  • Click Add Profile.
  • If the connector offers more than one authentication method, set the Auth Method filter to OAuth 2.0.
  • Select the actions, and any events, to enable for this Connector Profile.
  • Click Continue.
3

Set up authentication

  • Select Authentication Type as OAuth 2.0.
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
    • Subscription Key
    • Scopes (Optional)
  • Click Create Profile.
Congratulations! The new Connector Profile now shows up on the connector page. If you created it as a project member rather than an admin, it starts disabled until a project admin enables it. You can now continue to Link Accounts for Nmbrs.