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

# Sisense

> Connect your Sisense instance to Modus so your scopes have rich context about your dashboards and data models.

Connect your Sisense instance to Modus so its folders, dashboards, widgets, and
data models become context that Modus can reason over. Modus connects
**read-only** with a service account and stores your credentials encrypted in AWS
Secrets Manager.

## Prerequisites

Before you begin, make sure you have:

* Your **Sisense base URL** (e.g. `https://your-instance.sisense.com`).
* A **service account** username and password with read access (see below).

## Set up a service account

Create a dedicated Sisense user for Modus with **read access** to the content it
should use as context:

* Folders and dashboards
* Dashboard widgets
* Data models, tables, columns, and relationships

An **Admin** or **Super Admin** works, or a **custom role** with read access to
all of the above.

## Network access

If your Sisense instance is self-hosted or behind a firewall, allow Modus's
egress IP addresses so it can reach it. See [IP Allowlisting](/guides/ip-allowlist).

## Connect in Modus

<Steps>
  <Step title="Open the Sisense connection form">
    1. Log into [Modus](https://app.getmodus.com).
    2. Click **Integrations** in the left sidebar.
    3. Find the **Sisense** card under **BI & Visualization** and click **Connect**.
  </Step>

  <Step title="Fill in the connection details">
    Complete the form using the [field reference](#connection-form-field-reference) below.

    <Frame>
      <img src="https://mintcdn.com/modus-c77f86cb/1jIq7yXvNUfzqZYd/images/sisense-integration/connection-form.png?fit=max&auto=format&n=1jIq7yXvNUfzqZYd&q=85&s=b847d63cf83b4250dace7f8ec06e1398" alt="Modus Sisense connection form" width="1440" height="900" data-path="images/sisense-integration/connection-form.png" />
    </Frame>
  </Step>

  <Step title="Test and save">
    1. Click **Test Connection** to verify Modus can reach your instance.
    2. Click **Save Connection**.
  </Step>
</Steps>

## Connection form field reference

| Field                | Description                         | Example                             |
| -------------------- | ----------------------------------- | ----------------------------------- |
| **Connection Name**  | A friendly name for this connection | `Sisense Production`                |
| **Sisense Base URL** | Your Sisense instance URL           | `https://your-instance.sisense.com` |
| **Sisense Username** | The service account username        | `service-account@example.com`       |
| **Sisense Password** | The service account password        | *(your password)*                   |

## Troubleshooting

| Symptom                         | Likely cause                                                                                     |
| ------------------------------- | ------------------------------------------------------------------------------------------------ |
| **Authentication failed (401)** | Wrong username or password.                                                                      |
| **Access denied (403)**         | The account lacks read access to folders, dashboards, widgets, or data models.                   |
| **Connection failed / timeout** | Wrong base URL, or Modus's egress IPs aren't allowlisted. See [Network access](#network-access). |

## Verification

Your Sisense instance is now connected. Modus turns your folders, dashboards,
widgets, and data models into context so Modus can give accurate,
data-aware answers.

Need help? Contact us at [support@getmodus.com](mailto:support@getmodus.com).

<Note>
  Modus connects read-only and requests only the minimum access needed to
  understand your content. All credentials are encrypted and stored in AWS Secrets
  Manager — never in plaintext.
</Note>
