GraphQL API integration

After the approval of the registration of your web application, you can add integrations to Visma APIs. To integrate with Business NXT GraphQL API do the following:

1. Select your application from the My Applications main tab and go to Integrations.
2. Press the New integration button.
3. Search and select the Business NXT Graphql API in the combo with available APIs and press Continue. If you plan to use the client credentials grant type, then you need search for Business NXT GraphQL API in the combo with available APIs and press Continue.
4. Select the business-graphql-api:access-group-based scope (or business-graphql-service-api:access-group-based if you seleced Business NXT Graphql Service API in the previous step) and press Continue.
5. Review the selection and confirm the integration by pressing the Confirm Integration button.
6. Wait for the integration to be approved by Visma. Once approved, the integrations become active.

Once your application is integrated with Business NXT Graphql API, you can initiate the OAuth flow and create tokens.

The minimum required claims for a valid OAuth 2.0 JWT token are:

Default OAuth 2.0 Claim required:
    sub
Scope Claims required:
    email
    openid
    business-graphql-api:access-group-based

Company access is determined by the corresponding user for whom the OAuth JWT token was created. The rights for the user are managed in Visma.net.