Help menu Connect Toggl

Step-by-step

Connect Toggl

Set up Toggl Track as the time-tracking provider in TimeToBill.

Updated: 2026-04-25 Nederlandse versie

Here you connect Toggl Track to TimeToBill. You enter one API token. After that, TimeToBill can fetch your hours from Toggl.

What you need

  • A Toggl Track account with entries you want to invoice.
  • An active TimeToBill license.
  • Access to the email address you used to buy TimeToBill, for download links or your management link.

Request your download links or management link through Support if TimeToBill is not installed yet.

Step 1 - Get your Toggl API token

  1. Open Toggl Track.
  2. Click your profile icon in the lower-left corner.
  3. Open your profile page.
  4. Go to API Token at the bottom of the profile page.
  5. Copy the token.

You only need to paste the API token. TimeToBill finds your account and workspaces when you test the connection.

Step 2 - Connect Toggl in TimeToBill

  1. Open TimeToBill.
  2. Go to Settings -> Providers.
  3. Choose Toggl as the time tracker.
  4. Paste the Toggl API token.
  5. Test the connection.
  6. Save the settings.

During the connection test, TimeToBill looks up the available workspaces. If there is one workspace, the app selects it automatically. If there are multiple workspaces, choose the right workspace by name in TimeToBill.

Existing API credentials keep working. Test the connection again if TimeToBill asks to update the connection details.

These credentials are stored in your operating system's secure storage. TimeToBill stores your settings and billing status in a local TimeToBill file (.ttb) on your computer. API tokens are not stored in that file.

Step 3 - Fetch entries

  1. Choose a period.
  2. Click Fetch entries.
  3. Check that the right clients, projects, dates, descriptions, and duration are visible.
  4. Use filters if you only want to invoice part of the entries.

Toggl has API limits. TimeToBill accounts for them, but large invoicing sessions can take longer. You can turn tag write-back off to reduce the number of API calls.

Track billed entries

After creating an invoice, TimeToBill stores the billing status in your local TimeToBill file. You can also let the app write a tag back to Toggl, so the status is visible there too.

If you want to reduce API calls, you can turn tag write-back off.

Next

Connect your invoicing software, so TimeToBill can prepare your selection as a draft invoice.

Related pages