> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Nmbrs

> How to set up the Nmbrs connector, plus the actions and events that are available.

![Nmbrs](https://stackone-logos.com/api/nmbrs/filled/svg)

v3.0.1[See changelog](https://docs.stackone.com/connectors/nmbrs/changelog.md)

[70 actions](#actions) · [1 event](#events) · 1 auth method

HRIS

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [OAuth 2.0 · Connector Profile](https://docs.stackone.com/connectors/nmbrs/guides/connector-profile/oauth-2-0.md)
>
> Requires registering an integration in the Nmbrs developer portal and subscribing to an API product for a Subscription K...

Optionally, configure receiving Events for Nmbrs into StackOne.

> [card] [Webhooks setup](https://docs.stackone.com/connectors/nmbrs/guides/webhook-setup.md)

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [OAuth 2.0 · Link Account](https://docs.stackone.com/connectors/nmbrs/guides/link-account/oauth-2-0.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Scopes

Select all
|
Clear

company.info.read

company.leave.read

company.payrollsettings.read

debtor.info.read

document.read

employee.bankaccount

employee.bankaccount.read

employee.document

employee.document.read

employee.employment

employee.employment.read

employee.info

employee.info.read

employee.leave

employee.leave.read

employee.orgstructure

employee.orgstructure.read

employee.payment

employee.payment.read

user.info.read

No scopes found

70 actions

ActionDescriptionRequired scopes

List Employee Addresses History`nmbrs_list_employee_addresses_history`

Get addresses history.

`employee.info.read`

Create Employee Address`nmbrs_create_employee_address`

Create employee address.

`employee.info`

List Employee Bank Accounts History`nmbrs_list_employee_bank_accounts_history`

Get bank accounts history.

`employee.bankaccount.read`

Create Employee Bank Account`nmbrs_create_employee_bank_account`

Create employee bank account.

`employee.bankaccount`

Update Employee Bank Account`nmbrs_update_employee_bank_account`

Update employee bank account.

`employee.bankaccount`

List Companies`nmbrs_list_companies`

List all companies accessible to the authenticated Nmbrs user.

`company.info.read`

Get Company Current Period`nmbrs_get_company_current_period`

Get company current period.

`company.info.read`

List Companies By Debtor`nmbrs_list_companies_by_debtor`

Get company list by debtor.

`company.info.read`

List Company Contact Persons`nmbrs_list_company_contact_persons`

Get company contact persons.

`company.info.read`

List Accountant Contacts`nmbrs_list_accountant_contacts`

Get accountant contact persons.

`debtor.info.read`

List Contracts History`nmbrs_list_contracts_history`

Get contracts history.

`employee.employment.read`

Create Contract`nmbrs_create_contract`

Create employee contract.

`employee.employment`

Update Contract`nmbrs_update_contract`

Update employee contract.

`employee.employment`

List Company Cost Centers`nmbrs_list_company_cost_centers`

Get company cost centers.

`company.payrollsettings.read`

Update Employee Cost Center`nmbrs_update_employee_cost_center`

Update employee cost center.

`employee.payment`

List Company Cost Units`nmbrs_list_company_cost_units`

Get company cost units.

`company.payrollsettings.read`

List Countries`nmbrs_list_countries`

Get country codes.

`employee.info`

List Debtors`nmbrs_list_debtors`

Get debtor list.

`debtor.info.read`

Get Debtor Info`nmbrs_get_debtor_info`

Get debtor info.

`debtor.info.read`

List Debtor Tags`nmbrs_list_debtor_tags`

Get debtor tags.

`debtor.info.read`

List Departments`nmbrs_list_departments`

Get departments.

`employee.orgstructure.read`

Update Employee Department`nmbrs_update_employee_department`

Update employee department.

`employee.orgstructure`

Get Document Content`nmbrs_get_document_content`

Get document content.

`document.read`

Get Employee Payslip`nmbrs_get_employee_payslip`

Get employee payslip per period.

`employee.document.read`

List Employee Document Types`nmbrs_list_employee_document_types`

Get employee document types.

`employee.document.read`

Upload Employee Document`nmbrs_upload_employee_document`

Upload employee document.

`employee.document`

List Employees`nmbrs_list_employees`

Get employee list.

`employee.info.read`

Get Employee`nmbrs_get_employee`

Get an employee.

`employee.info.read`

List Employees Personal Info History`nmbrs_list_employees_personal_info_history`

Get employees history.

`employee.info.read`

Create Employee`nmbrs_create_employee`

Create employee.

`employee.info`

Update Employee Personal Info`nmbrs_update_employee_personal_info`

Update employee personal info.

`employee.info`

Update Employee Social Security Number`nmbrs_update_employee_social_security_number`

Update employee social security number.

`employee.info`

List Company Default Templates`nmbrs_list_company_default_templates`

Get default employee templates.

`employee.info`

List Employments History`nmbrs_list_employments_history`

Get employments history.

`employee.employment.read`

List End Contract Reasons`nmbrs_list_end_contract_reasons`

Get end contract reasons.

`employee.employment.read`

Create Employment`nmbrs_create_employment`

Create employment.

`employee.employment`

Update Employment`nmbrs_update_employment`

Update employment.

`employee.employment`

List Functions`nmbrs_list_functions`

Get functions.

`employee.orgstructure.read`

Update Employee Function`nmbrs_update_employee_function`

Update employee function.

`employee.orgstructure`

List Employee Fixed Hours`nmbrs_list_employee_fixed_hours`

Get fixed hours per employee.

`employee.payment.read`

List Employee Variable Hours`nmbrs_list_employee_variable_hours`

Get variable hours per employee.

`employee.payment.read`

Create Employee Fixed Hours`nmbrs_create_employee_fixed_hours`

Create fixed hours.

`employee.payment`

Create Employee Variable Hours`nmbrs_create_employee_variable_hours`

Create variable hours.

`employee.payment`

List Company Hour Codes`nmbrs_list_company_hour_codes`

Get company hour codes.

`company.payrollsettings.read`

List Absences History`nmbrs_list_absences_history`

Get employees absences history.

`employee.leave.read`

List Leave Balances`nmbrs_list_leave_balances`

Get employees leave balances.

`employee.leave.read`

List Leave Requests History`nmbrs_list_leave_requests_history`

Get leave requests history.

`employee.leave.read`

List Parental Leave History`nmbrs_list_parental_leave_history`

Get employee parental leave history.

`employee.leave.read`

List Leave Groups`nmbrs_list_leave_groups`

Get company leave groups.

`company.leave.read`

Create Leave Request`nmbrs_create_leave_request`

Create leave request.

`employee.leave`

Delete Leave Request`nmbrs_delete_leave_request`

Delete employee leave request.

`employee.leave`

Create Employee Absence`nmbrs_create_employee_absence`

Create employee absence.

`employee.leave`

List Managers`nmbrs_list_managers`

Get managers.

`employee.orgstructure.read`

Update Employee Manager`nmbrs_update_employee_manager`

Update employee manager.

`employee.orgstructure`

List Company Payroll Runs`nmbrs_list_company_payroll_runs`

Get company payroll runs.

`company.payrollsettings.read`

List Payroll Run Employees`nmbrs_list_payroll_run_employees`

Get employees in payroll run.

`company.payrollsettings.read`

List Salaries History`nmbrs_list_salaries_history`

Get salaries history.

`employee.employment.read`

List Cost Per Hour`nmbrs_list_cost_per_hour`

Get cost per hour.

`employee.employment.read`

Create Employee Salary`nmbrs_create_employee_salary`

Create employee salary.

`employee.employment`

List Company Salary Tables`nmbrs_list_company_salary_tables`

Get company salary table history.

`company.payrollsettings.read`

Get Salary Table Content`nmbrs_get_salary_table_content`

Get salary table content.

`company.payrollsettings.read`

Get Salary Table Versions`nmbrs_get_salary_table_versions`

Get salary table versions.

`company.payrollsettings.read`

List Employees User Accounts`nmbrs_list_employees_user_accounts`

Get employees user accounts.

`employee.info.read`

Get User Info`nmbrs_get_user_info`

Get user info.

`user.info.read`

List Employee Fixed Wage Components`nmbrs_list_employee_fixed_wage_components`

Get fixed wage components.

`employee.payment.read`

List Employee Variable Wage Components`nmbrs_list_employee_variable_wage_components`

Get variable wagecomponents.

`employee.payment.read`

Create Employee Fixed Wage Component`nmbrs_create_employee_fixed_wage_component`

Create fixed wagecomponent.

`employee.payment`

Create Employee Variable Wage Component`nmbrs_create_employee_variable_wage_component`

Create variable wagecomponent.

`employee.payment`

List Company Fixed Wage Components`nmbrs_list_company_fixed_wage_components`

Get company fixed wage components history.

`company.payrollsettings.read`

List Company Variable Wage Components`nmbrs_list_company_variable_wage_components`

Get company variable wage components history.

`company.payrollsettings.read`

## Events

Tags

Select all
|
Clear

Payroll Runs

Webhooks

No tags found

1 event

EventDescriptionTags

Payroll Run Finished`nmbrs_webhook_run_finish`

Processes Nmbrs Run Finish webhook events, emitted when a payroll run completes for a company.

Payroll RunsWebhooks


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.