Skip to main content

Overview

The Toggl Track API authenticates with HTTP Basic Auth. Nango stores a username and password pair that map to one of two supported combinations:
  1. Email and passwordusername is your Toggl Track account email and password is your account password.
  2. API tokenusername is your personal API token and password must be the literal string api_token.
This guide explains how to obtain credentials and enter them in the Connect UI.

Prerequisites

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.
  2. Find your API token (personal token) and copy it.
  1. In Nango, set Email or API token to the token value.
  2. Set Password or api_token to exactly api_token (the word api_token, not your account password).
Using an API token avoids storing your main account password and can be rotated independently. See Toggl’s authentication documentation.

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.
You are now connected to Toggl Track.