Skip to main content

Toggl Track

Connection

Frihet turns Toggl Track hours into invoices in two ways: one click from the Data tab (current month), or from the Timesheet Billing tab under Invoices, where you pick the client, dates and rate. There is no synchronization with Toggl Track.

What Frihet does​

  • Stores the Toggl Track credential and the workspace you pick securely:
    • Toggl Track API Token (stored encrypted)
  • Test connection — Frihet checks the credential by requesting your user from Toggl Track.
  • Import time entries (Data tab) — asks for an hourly rate, fetches the entries of the current month up to today from the connected workspace and creates a single draft invoice with one line per project: hours summed and multiplied by the rate you entered.
  • The invoice is numbered TGL-YYYY-MM-DD-YYYY-MM-DD (start and end dates of the range), with 0% VAT, a 30-day due date and no client assigned. Assign the client and review the taxes when you edit the draft.
  • If an invoice with that same number already exists, it does not create another one.
  • Timesheet Billing tab under Invoices — pick the client, the connected integration, the hourly rate and the start and end dates. Import & Preview shows the entries and the total hours, and Generate Draft Invoice opens a new invoice for that client with one line per project.

What Frihet does not do​

  • Synchronize or import hours automatically or on a schedule: each import is one click on the button.
  • Pick specific projects: every entry in the range is imported. The Data tab button always uses the current month; for other dates, use the Timesheet Billing tab under Invoices.
  • Apply rates per client or per project: there is one rate, the one you type when importing.
  • Match projects to Frihet clients or create clients.
  • Send anything to Toggl Track: hours only flow from Toggl Track to Frihet.

Requirements​

  • A Toggl Track account with logged hours
  • Toggl Track API Token
  • Each connected integration counts toward your plan limit: 2 on Free, 5 on Pro, unlimited on Premium.

Connect​

Step 1: get the credential in Toggl Track​

  1. Go to track.toggl.com and sign in.
  2. Open your profile (Profile settings).
  3. Copy the API Token at the bottom of the page.

Step 2: save it in Frihet​

  1. In Frihet, go to Integrations.
  2. Open Toggl Track.
  3. On the Connection tab, paste the credential.
  4. Click Test connection: if it succeeds, your workspaces appear.
  5. Select the workspace and click Save connection.

Import hours​

  1. Open the Data tab of the integration.
  2. Click Import time entries.
  3. Enter the hourly rate in euros.
  4. Review the resulting draft in your invoices, assign the client and adjust the VAT.

Entries without a duration (running timers) count as 0 hours. The range ends on the day you import: if you import on another day of the same month, another invoice is created that repeats the hours already included in the previous one. Review the drafts before issuing them.

Bill hours to a client​

  1. Go to Invoices and open the Timesheet Billing tab.
  2. Choose Client, Integration, Hourly rate (€/h), Start Date and End Date.
  3. Click Import & Preview.
  4. Click Generate Draft Invoice, review the invoice that opens (taxes included) and save it.

Troubleshooting​

Connection error​

Check that the credential is copied correctly and that you have not regenerated it in Toggl Track. If you did, save the new one.

The import creates no invoice​

There may be no hours logged in the current month, or an invoice with the same number (same start and end date) may already exist.

Last updated on