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

# Mode

## Obtain credentials from Mode

> [!NOTE]
>
> **INFO**
>
> To complete this integration, your **Mode** account must be a part of a [Mode Business Workspace](https://mode.com/compare-plans) in order to generate an API Token.

> [!NOTE]
>
> **INFO**
>
> You need to have **Admin** privileges in your Mode Workspace to be able to create an API Token.

In **Mode**, navigate to **Workspace Settings** → **Privacy & Security** → **API**.

Click the  icon, and choose **Create new token**.

![](https://mintcdn.com/datafold/4ZNRDufNo9R1p08Q/images/tokens-40fd2f50b2ec5d0acc295c11ae9e0548.png?fit=max\&auto=format\&n=4ZNRDufNo9R1p08Q\&q=85\&s=218032a87bc1d3f56b623a1eec0a9a00)

Tokens

Take note of:

* Token Name,
* Token Password,
* And the URL of the page that lists the tokens. It should look like this:

  [https://app.mode.com/organizations/\{workspace}/api\_keys](https://app.mode.com/organizations/\{workspace}/api_keys)

Take note of `{workspace}` part, we will need it when configuring Datafold.

## Configure Datafold

Navigate to **Settings** → **Integrations** → **BI & Data Apps**.

![](https://mintcdn.com/datafold/Q7OqZ4fuuETHBSvX/images/data_apps_add_new_integration-8fa569d0d0beb7191934287bdcdda2f1.png?fit=max\&auto=format\&n=Q7OqZ4fuuETHBSvX\&q=85\&s=bd09718379ccede369a6e1b6738524c4)

Add New Integration

Choose **Mode** Integration to add.

![](https://mintcdn.com/datafold/hQ4DukKOuaj6vjhH/images/choose-type-bf9b2d554dc7739742b1f007c9bef227.png?fit=max\&auto=format\&n=hQ4DukKOuaj6vjhH\&q=85\&s=064bac3962b7e9812daae5972457b5c2)

Choose Type

This will bring up **Mode** integration parameters.

![](https://mintcdn.com/datafold/hQ4DukKOuaj6vjhH/images/create-585f8b3a1e9f38c5bde10e6528e0c6b4.png?fit=max\&auto=format\&n=hQ4DukKOuaj6vjhH\&q=85\&s=7ec9e93eb717c2a1c1becefe2c29a768)

Create Integration

Complete the configuration by specifying the following fields:

| Field Name | Description |
| - | - |
| Integration name | An identifier used in Datafold to identify this Data App configuration. |
| Token | API token, as generated above. |
| Password | API token password, as generated above. |
| Workspace Name | Workspace name obtained from your workspace URL. |

> [!NOTE]
>
> **INFO**
>
> **Workspace Name** field is not marked as required on this screen. That's for backwards compatibility: the legacy type of Mode API token, known as **Personal Token**, does not require that parameter. However, such tokens can no longer be created, so we're no longer providing instructions for them.

When completed, click **Save**.

Datafold will try to connect to Mode and, if any issues with the connection arise you will be alerted.

Datafold will start to sync your reports. It can take some time to fetch all the reports, depending on how many of them there are.

> [!TIP]
>
> **TIP**
>
> [Tracking Jobs](https://docs.datafold.com/classic/integrations/bi-data-apps/tracking-jobs.md) explains how to find out when your data app integration is ready.

Now that Mode sync has completed — you can browse your Mode reports!

![](https://mintcdn.com/datafold/BHI8Zy_v4DyXlmzL/images/mode_sync_results-dd76443d59234b676d29c6999f278c48.png?fit=max\&auto=format\&n=BHI8Zy_v4DyXlmzL\&q=85\&s=5d53ed5013896c0e70df4d551e6478ab)

Tokens


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.