# Tenants

This section provides an overview of your **tenants**. It shows the number of Monthly Active Accounts (MAA) per tenant, the tenant expiration, status, as well as a link to jump into the [Tenant Administration UI](broken://pages/xT9DB1eLOv3hNxZlVxGT) for each tenant.

You can create new tenants from here. You can create up to 3 tenants, the free contingent in any subscription plan, until you are required to provide billing information.

<figure><img src="/files/hepUj2SFIcNBi4aUYBKc" alt=""><figcaption><p>Tenants in the Quasr Account UI</p></figcaption></figure>

## Tenant Creation via Management API

You can also create tenants through the [Management API](/quasr/tenant-administration/apis/management-api-graphql.md).

The example call below with the following input variables:

```json
{
  "input": {
    "label": "Demo Tenant",
    "subscription": "sub_1Klq....", // a valid current subscription
    "status": "ENABLED",
    "config": {
      "color": "#660000"
    }
  }
}
```

creates a tenant with **label** `Demo Tenant` under your chosen **subscription**, **status** set to `ENABLED`, and a **color** code of #`660000`.

You find your **subscription number** under the *Account Administration UI > Account & Billing > Subscriptions* ("Subscription Number").

### GraphQL Example

```graphql
// GraphQL Query (Sample)
mutation createTenant ($input: CreateTenantInput!) {
    createTenant (input: $input) {
        id        
    }
}

// GraphQL Variables (Sample)
{
  "input": {
    "label": "Demo Tenant",
    "subscription": "sub_1KlqjQL3CzwCmC47Gn4xxxxx",
    "status": "ENABLED",
    "config": {
      "color": "#660000"
    }
  }
}

// Response (Sample)
{
    "data": {
        "createTenant": {
            "id": "ace6eb2f-2fc8-4870-9d48-f897ed1f81cb"
        }
    }
}
```

### Node.js Example

```javascript
var axios = require('axios');
var data = JSON.stringify({
  query: `mutation createTenant ($input: CreateTenantInput!) {
    createTenant (input: $input) {
        id        
    }
}`,
  variables: {"input":{"label":"Demo Tenant","subscription":"sub_1KlqjQL3CzwCmC47Gn4xxxxx","status":"ENABLED","config":{"color":"#660000"}}}
});

var config = {
  method: 'post',
  url: 'https://{tenant_id}.api.quasr.io/graphql',
  headers: { 
    'Authorization': 'Bearer {access_token}', 
    'Content-Type': 'application/json'
  },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.quasr.io/quasr/account-administration/tenants.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.