Introduction
Although this documentation explains how to use the Business NXT API it does not provide learning materials for the GraphQL language. If you are not already familiar with GraphQL, we recommend you first take the Introduction to GraphQL tutorial (from the official GraphQL page) and other learning materials.
Endpoints
The Business NXT GraphQL endpoints are:
| URL | Description |
|---|---|
https://business.visma.net/api/graphql | For querying from a Visma.net user context (authentication using Authentication Code with PKCE). See Web applications for more. |
https://business.visma.net/api/graphql-service | For querying from a service context (authentication using Client credentials). See Services for more. |
Notifications
Business NXT supports Visma Connect Webhooks. With webhooks, your application gets a notification whenever there is a change in a company’s database. The notifications will only contain a table identifier and a primary key, so it can be used in combination with Graphql API to get the latest version of the changed row.
Quick start
Resources
We recommend the following resources for learning more about GraphQL:
Section Content
Getting started with GraphQL queries
We will explore the schema shortly. However, to get started with the API and understand how easy it is to query data from Business NXT, we will look at several simple examples.
Exploring the API
This section introduces testing GraphQL endpoint queries using tools like GraphiQL and Postman, and details the POST request structure with a “GetCustomers” query example.