---
title: "Application registration"
description: "Guidance on registering a service application in the Visma Developer Portal, covering steps, approval, credentials, and local development setup."
lang: en
languages:
  en: https://docs.vismasoftware.no/businessnxtapi/authentication/service/application_registration/index.md
lastmod: 2026-08-18
---

> Documentation index: https://docs.vismasoftware.no/businessnxtapi/authentication/service/llms.txt


# Application registration

Last modified August 18, 2026

> Guidance on registering a service application in the Visma Developer Portal, covering steps, approval, credentials, and local development setup.


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. This section describes how to register a service application.

> [TIP]
>
> If you are not familiar with the OAuth authorization flows, we recommend that you first read carefully the page [Understanding OAuth](https://docs.vismasoftware.no/businessnxtapi/authentication/oauth/index.md) 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 API.

You must follow these steps:

1. Logon to [Visma Developer Portal](https://oauth.developers.visma.com).

2. From the menu, select **My Applications** and then press the **Add applications** button.
![Add application](https://docs.vismasoftware.no/businessnxtapi/authentication/service/app_setup01.png)

3. Select the **Service** application type.
![alt text](https://docs.vismasoftware.no/businessnxtapi/authentication/service/srv_setup01.png)

4. Fill in the registration form. You must select an application name, a unique client identifier, and a description of your application. When completed, you must press the **Save as draft** button and then **Send for approval**.
![Registration form](https://docs.vismasoftware.no/businessnxtapi/authentication/service/srv_setup02.png)

5. Your application must be approve by Visma before you can start using it. Before approval, it will display the *Pending approval* status.

> [!WARNING]
>
> Because the **client ID** needs to be stored in the **User** table (see [User setup](https://docs.vismasoftware.no/businessnxtapi/authentication/service/user_setup/index.md) page) and there is a limitation of 24 characters for names in this table, please make sure the value for the **client ID** does not exceed this limit.

After the approval process complete, you can add integrations to your application. See [GraphQL API integration](https://docs.vismasoftware.no/businessnxtapi/authentication/service/integrations_service/index.md) to learn how to do that.

## Application Credentials

In order to perform the authentication flow using the client credentials grant type, you must have both a *client identifier* and a *client secret*. Client secrets can be generated (and deleted) from the **Credentials** tab in Visma Developer Portal.

![Pending approval](https://docs.vismasoftware.no/businessnxtapi/authentication/service/srv_setup03.png)

> [!NOTE]
>
> A secret is only visible when it is generated after which you can no longer read it. You must copy and preserve it in a secure place.

## Local App Development

For the development of your application on local machines, you must register a local URL for login and redirect. The use of `localhost` is not supported in the Visma Developer Portal but `app.local` can be used instead. Assuming your application runs locally on the 12345 port, use the following configuration:

```
Initiate Login URI:      https://app.local:12345/
Frontchannel Logout URI: https://app.local:12345/logout
Redirect URIs:           https://app.local:12345/signin-oidc
```

---

[View this page](https://docs.vismasoftware.no/businessnxtapi/authentication/service/application_registration/)