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

<Note>
  **INFO**

  You need to have **Admin** privileges in your Mode Workspace to be able to create an API Token.
</Note>

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

Click the <Icon icon="gear" /> icon, and choose **Create new token**.

<Frame caption="Tokens">
  <img src="https://mintcdn.com/datafold/4ZNRDufNo9R1p08Q/images/tokens-40fd2f50b2ec5d0acc295c11ae9e0548.png?fit=max&auto=format&n=4ZNRDufNo9R1p08Q&q=85&s=218032a87bc1d3f56b623a1eec0a9a00" width="1691" height="267" data-path="images/tokens-40fd2f50b2ec5d0acc295c11ae9e0548.png" />
</Frame>

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

<Frame caption="Add New Integration">
  <img src="https://mintcdn.com/datafold/Q7OqZ4fuuETHBSvX/images/data_apps_add_new_integration-8fa569d0d0beb7191934287bdcdda2f1.png?fit=max&auto=format&n=Q7OqZ4fuuETHBSvX&q=85&s=bd09718379ccede369a6e1b6738524c4" width="2102" height="646" data-path="images/data_apps_add_new_integration-8fa569d0d0beb7191934287bdcdda2f1.png" />
</Frame>

Choose **Mode** Integration to add.

<Frame caption="Choose Type">
  <img src="https://mintcdn.com/datafold/hQ4DukKOuaj6vjhH/images/choose-type-bf9b2d554dc7739742b1f007c9bef227.png?fit=max&auto=format&n=hQ4DukKOuaj6vjhH&q=85&s=064bac3962b7e9812daae5972457b5c2" width="1073" height="667" data-path="images/choose-type-bf9b2d554dc7739742b1f007c9bef227.png" />
</Frame>

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

<Frame caption="Create Integration">
  <img src="https://mintcdn.com/datafold/hQ4DukKOuaj6vjhH/images/create-585f8b3a1e9f38c5bde10e6528e0c6b4.png?fit=max&auto=format&n=hQ4DukKOuaj6vjhH&q=85&s=7ec9e93eb717c2a1c1becefe2c29a768" width="1059" height="706" data-path="images/create-585f8b3a1e9f38c5bde10e6528e0c6b4.png" />
</Frame>

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        | 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.
</Note>

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](/integrations/bi-data-apps/tracking-jobs) explains how to find out when your data app integration is ready.
</Tip>

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

<Frame caption="Tokens">
  <img src="https://mintcdn.com/datafold/BHI8Zy_v4DyXlmzL/images/mode_sync_results-dd76443d59234b676d29c6999f278c48.png?fit=max&auto=format&n=BHI8Zy_v4DyXlmzL&q=85&s=5d53ed5013896c0e70df4d551e6478ab" width="1720" height="1082" data-path="images/mode_sync_results-dd76443d59234b676d29c6999f278c48.png" />
</Frame>