> ## Documentation Index
> Fetch the complete documentation index at: https://nango-marcin-nan-6306-mcp-tool-connections-get.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Toggl Track - How do I link my account?

# Overview

The [Toggl Track API](https://developers.track.toggl.com/docs/introduction) authenticates with **HTTP Basic Auth**. Nango stores a username and password pair that map to one of two supported combinations:

1. **Email and password** — `username` is your Toggl Track account email and `password` is your account password.
2. **API token** — `username` is your [personal API token](https://track.toggl.com/profile) and `password` must be the literal string `api_token`.

This guide explains how to obtain credentials and enter them in the Connect UI.

### Prerequisites

* A [Toggl Track](https://track.toggl.com/) account

#### Step 1: Choose email/password or API token

**Option A — Email and password**

Use the same email and password you use to sign in to Toggl Track.

**Option B — API token (recommended for integrations)**

1. Sign in to Toggl Track and open your [profile](https://track.toggl.com/profile).
2. Find your **API token** (personal token) and copy it.

<img src="https://mintcdn.com/nango-marcin-nan-6306-mcp-tool-connections-get/OFX6oY7aR3Od551R/api-integrations/toggl/api_key.png?fit=max&auto=format&n=OFX6oY7aR3Od551R&q=85&s=3420acf8aaf370961d2a9b4811c0e9f5" width="1910" height="779" data-path="api-integrations/toggl/api_key.png" />

3. In Nango, set **Email or API token** to the token value.
4. Set **Password or api\_token** to exactly `api_token` (the word `api_token`, not your account password).

<Tip>Using an API token avoids storing your main account password and can be rotated independently. See [Toggl’s authentication documentation](https://developers.track.toggl.com/docs/authentication).</Tip>

#### Step 2: Enter credentials in the Connect UI

1. Open the form where you need to authenticate with Toggl Track.
2. Enter **Email or API token** and **Password or api\_token** as described above.
3. Submit the form, and you should be successfully authenticated.

<img src="https://mintcdn.com/nango-marcin-nan-6306-mcp-tool-connections-get/OFX6oY7aR3Od551R/api-integrations/toggl/form.png?fit=max&auto=format&n=OFX6oY7aR3Od551R&q=85&s=870e269b86cb56ff26ef9b73cd5361c3" style={{maxWidth: "450px" }} width="501" height="701" data-path="api-integrations/toggl/form.png" />

You are now connected to Toggl Track.