Documentation

Step by step to connect

Below you can find a detailed step by step on how to connect to the Visma Nmbrs REST API:

1. Sign up to Become a Partner form on the AppStore

The appstore.nmbrs.com is where all our integrations are available. Right now the REST API is only available for partners who intend to be part of our public marketplace.

To make sure there is a good connect fit, we expect partners to sign up to the partner form. Then, the Integration Partner Manager will reach out to schedule a (virtual) coffee. The coffee is not a blocker to do the following steps, we recommend to already sign up and subscribe to the product to speed up.

2. Sign up to Nmbrs Developer Portal

To use the Nmbrs REST API, the developer must be sign up to the developer portal and have an active login. 

3. Subscribe to a product

After signing up, it's necessary to a subscribe to a product, which will generate a subscription key which must be used on every API request. 

4. Create a Nmbrs account

To be able to test the API, it's necessary to have a Nmbrs test account. It's very important to follow the instructions on Create a Nmbrs account.

5. Register your app 

After signing in, navigate to our "My Integrations" tab, there you can add your application and edit existing ones. A client ID and secret will be created so that you can start building as soon as possible

6. Use the API 

Read the documentation on how to authenticate, explore which API endpoints are available and what errors means. 

Mock Server

Before getting into the details on how to connect, you can explore the mock server for the Nmbrs REST API! With it, you can see how the responses will look like and experiment with the endpoints.

You can see very easily how the API will work. TRY IT!

API Mock server

Technical documentation

When all the steps above are done, you can go through the technical documentation and find:

• how to authenticate

• error handling

• pagination and versioning strategy