---
title: "Add an API integration"
slug: "add-an-api-integration"
updated: 2024-04-19T12:01:38Z
published: 2024-04-19T12:01:38Z
canonical: "docs.connect.visma.com/add-an-api-integration"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.connect.visma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add an API integration

Once you have published your application you can configure integration with API(s).

#### You add an API integration to your Application in 2-ways, the outcome will be the same.

1. By going to your application and the “Integrations” section and clicking “New Integration”.
2. Or by finding your desired API from the “APIs” top menu and clicking “New Integration” on that specific APIs page, then selecting your Application

#### All available APIs can be found under “APIs” in the top menu.

Each API has its own details page that provides additional information: Name, Base URL, Documentation, Permission type and Permissions (OAuth Scopes). Integration with the API can be triggered directly from this page.

> [!NOTE]
> Your App must be compatible with the API
> 
> If your App settings are not compatible with the API then your App will not show up in the dropdown of selectable Applications.

1. Choose one of your application(s) for which the integration is configured

![DevPortal_apiIntegrationsNew](https://cdn.document360.io/0ec30182-e256-4eca-ab6a-d067d83d0895/Images/Documentation/DevPortal_apiIntegrationsNew.png)

1. Select the API permission(s) your application needs.

![DevPortal_apiIntegrationsScopes](https://cdn.document360.io/0ec30182-e256-4eca-ab6a-d067d83d0895/Images/Documentation/DevPortal_apiIntegrationsScopes.png)

1. If the API requires approval by API team, then add a message to them and confirm the integration request.

![DevPortal_apiIntegrationsSummary](https://cdn.document360.io/0ec30182-e256-4eca-ab6a-d067d83d0895/Images/Documentation/DevPortal_apiIntegrationsSummary.png)

1. Once your App ([Native](/v1/docs/native-applications), [SPA](/v1/docs/single-page-applications) or [Web](/v1/docs/server-side-web-applications)) is integrated with the API scope(s) you must request the desired scope(s) in the **/connect/authorize** request using the **scope** parameter. If your App is a [Service](/v1/docs/service-applications), you must request the desired scope(s) in the **/connect/token** request using the **scope** parameter.

> [!NOTE]
> Depending on the API configuration, scopes will be added automatically to your application, or will go through an approval process.
> 
> The Status of each integration can be checked under application's **Integrations** page.