Application registration
Guidance on registering a service application in the Visma Developer Portal, covering steps, approval, credentials, and local development setup.
Services
Guide for integrating services with Business NXT via GraphQL, including registration, authentication, and setup instructions on Visma Developer Portal.
In order to integrate with Business NXT you must register an application in the Visma Developer Portal and add an integration to Business NXT GraphQL. Here, you will learn how to do this.
Services are application do not require user interaction. They enable a machine-to-machine integration. If you do not require user interaction, this is the type of application you should use.
To integrate your service with Business NXT using GraphQL, you must do the following:
- Register your service with the Visma Developer Portal.
- Register an integration with the Business NXT GraphQL API.
- Register a user to impersonate your service in Business NXT.
- Perform authentication with the client credentials grant type.
- Use the https://business.visma.net/api/graphql-service URL for queries.
In this section, we discuss each of these points.
Tip
If you are not familiar with the OAuth authorization flows, we recommend that you first read carefully the page Understanding OAuth to familiarize yourself with concepts such as authentication and authorization, access tokens, scopes, grants, endpoints and redirect URLs. You need to have a basic understanding of these concepts in order to properly register your application and setup an integration with Business NXT GraphQL Service API.
GraphQL API integration
Guide for integrating Visma’s Business NXT GraphQL API, including selecting APIs, confirming integrations, and initiating OAuth flow post-approval.
User Setup
API documentation for setting up a new user in Business NXT, including creating layouts and assigning application access roles.
Examples for setting up authorization
Here you can find some examples for how to set up authorization.