---
title: "Default Tenant"
slug: "default-tenant"
updated: 2026-03-24T12:00:29Z
published: 2026-03-24T12:00:29Z
canonical: "docs.connect.visma.com/default-tenant"
---

> ## 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.

# Default Tenant

For **applications** using the `client_credentials` flow, API access is typically performed in the context of a specific tenant (customer). This means that a `tenant_id` must normally be included in the token request to indicate which tenant’s data the application should access.

The `tenant_id` parameter is a **non-standard extension** to the OAuth 2.0 specification. Because of this:

- Not all OAuth clients or libraries support sending it
- Some tools and integrations make it difficult or impossible to include custom parameters in token requests

The **Default Tenant** feature addresses this limitation by allowing you to configure a predefined tenant directly on the application.

When a Default Tenant is set:

- The application will automatically use the configured tenant context
- The `tenant_id` parameter no longer needs to be sent in token requests
- Token requests become simpler and more compatible with standard OAuth clients

This is especially useful for:

- Single-tenant integrations
- Backend services with a fixed customer context
- Environments where OAuth clients cannot send custom parameters

## How to configure a Default Tenant

If your Application has been assigned Tenant(s), follow these steps in the Developer Portal:

1. Go to **My Applications**
2. Select your application
3. Go to **Integrations** in the left-menu
4. Select **Customers** tab
5. Click “Set default tenant”
6. Choose the Tenant you want to set as default
7. Confirm the **Default Tenant**

**Note that if your Application has not been assigned any Tenant, this will not be available for you.**

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

Set a **Default Tenant** from the list of Tenants available to your Application.

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

Now you can do a [Client Credentials token request](/v1/docs/service-applications) without specifying the Tenant ID parameter.
