Skip to main content
Select Actions to adjust the guide
Some actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.
Action
Scope(s)
Loading actions…
Dynamic Guide URL
Scopes Selected
Separator
​
Register OAuth integration
Create an integration in the developer portal to obtain Client ID and Client Secret.
1
Sign in to Nmbrs
Sign in to your Nmbrs developer portal.
  • Navigate to the My Integrations tab and click Create new integration.
2
Fill in the Details tab
On the Details tab, provide the integration metadata and the StackOne redirect URL, then click Save.
  • App name: e.g. stackone-nmbrs
  • App description: short description of the integration
  • Application type: select Web
  • Icon URL: a public image URL for the integration icon
  • Redirect URLs: add https://api.stackone.com/connect/oauth2/nmbrs/callback — it must match exactly. The OAuth flow rejects redirect URIs that aren’t registered.
  • Click Save.
3
Generate the Client Secret
Open the Secrets tab. The Client ID is shown at the top — copy it. Then click Generate Secret and copy the secret value immediately.
  • The Client Secret is shown only once on generation — store it securely; you cannot retrieve it later.


​
Available OAuth scopes
Nmbrs grants every integration access to the full scope catalog — there is no per-integration scope allowlist in the Nmbrs portal (the Helper tab only previews scopes for an example authorize URL). Pick the scopes your StackOne connection should request from the list below. Always include offline_access so the connection can be kept alive past the 1-hour access-token expiry.
1
Pick the scopes you need
Enables actions: Create Contract, Create Employee, 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 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 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
Each scope corresponds to a group of Nmbrs actions. The minimal default covers every action shipped in this connector.


​
Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for Nmbrs:

1
Navigate to Connector Profiles
Login to StackOne and navigate to Connector Profiles
2
Create New Connector Profile
  • Click + Connector Profile
  • Search for and select Nmbrs
  • Select Type as OAuth 2.0
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
    • Scopes (Optional)
  • (Optional) Select Actions to be enabled for this Connector Profile
  • Click Save

Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for Nmbrs.