Skip to main content

Toggl Track

Available

This integration is active and ready to use on all Pro plans.

Connect Toggl Track to Frihet. Import your logged hours and convert time into invoices.

What is it for?​

With Toggl integrated:

  • Import hours — Bring your time entries into Frihet
  • Create invoices from hours — Convert hours into invoices per client
  • Configurable rate — Define price/hour per client
  • Projects and tasks — Group by project for detailed invoices

Requirements​

  • Active Toggl Track account — You need to have time logged
  • Toggl API Key — To connect
  • Frihet Pro or higher

Get your Toggl API Key​

Step 1: Open Toggl​

  1. Go to track.toggl.com
  2. Log in
  3. In the bottom-left corner, click your name
  4. Select Profile settings (gear icon)

Step 2: Find your API Key​

  1. In Profile settings, go to API Token
  2. You will see a long token (e.g., a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6)
  3. Copy it (important: keep it safe, do not share)

Connect Toggl to Frihet​

Step 1: Open Frihet​

  1. Go to Settings → Integrations
  2. Find Toggl Track
  3. Click Connect

Step 2: Enter your API Key​

  1. Paste the Toggl token
  2. Click Verify connection
  3. If correct, you will see "✅ Connected"

Step 3: Configure synchronization​

  1. Choose which projects to sync:

    • All projects ✅
    • Only specific projects ⚪

  2. Define default rate:

    • Example: €60/hour
    • You can change it per client later

  3. Save

Import logged hours​

Option 1: Manual import​

  1. In Frihet, go to Invoicing → Import from Toggl
  2. Choose date range:
    • "This month"
    • "Last 7 days"
    • "Custom dates"
  3. Select which projects to import
  4. Click "Import"
  5. Draft invoices are created (you can review before saving)

Option 2: Automatic synchronization​

If you activate it in Settings:

  1. Daily, Frihet automatically imports your Toggl hours
  2. It groups them by client
  3. Creates draft invoices
  4. You review and confirm them

Example: Convert hours to invoice​

In Toggl​

Proyecto: Diseño Web - Cliente XYZ
- Lunes 3 feb: 5 horas (Diseño UI)
- Miércoles 5 feb: 3 horas (Desarrollo)
- Total: 8 horas

Proyecto: Consultoría - Juan García
- Jueves 6 feb: 2 horas (Reunión)
- Total: 2 horas

In Frihet (after import)​

Invoice #1 - Client XYZ

Concept: Web Design
- 5 hours @ €60 = €300
- 3 hours @ €60 = €180
Total: €480

Breakdown:
- Feb 3: 5h UI Design
- Feb 5: 3h Development

Invoice #2 - Juan García

Concept: Consulting
- 2 hours @ €60 = €120

Breakdown:
- Feb 6: 2h Meeting

Custom client-specific rates​

By default, all clients use the €60/h rate. You can change it:

Option 1: Edit on the invoice​

  1. The invoice is created
  2. Before confirming, manually change the rate
  3. Hours are automatically recalculated

Option 2: Fixed rate per client​

  1. Go to Clients → open a client
  2. In "Toggl Rate", enter €80/hour
  3. The next import uses that rate for that client

Detailed task breakdown​

If you use task descriptions in Toggl, Frihet includes them:

En Toggl:
- 10:00-12:00 "Reunión con cliente" (2h)
- 14:00-16:30 "Correcciones de diseño" (2.5h)

In Frihet it appears as:

Invoice:
- Meeting with client: 2h @ €60 = €120
- Design corrections: 2.5h @ €60 = €150
Total: €270

You can edit each line before confirming.

Projects and clients​

Automatic mapping​

Frihet tries to map:

Toggl Project "Client A"
→ Frihet Client "Client A"

If the client does not exist:
→ Frihet automatically creates it

Manual mapping​

If you want a Toggl project to go to a different client:

  1. Go to Settings → Toggl → Project Mapping
  2. For each project, choose a Frihet client
  3. Save

Example:

Toggl Project "Diseño Q1"
→ Asignar a cliente Frihet "Empresa SL"

Test the integration​

Test import​

  1. In Toggl, log one hour: "Test task" (1 hour)
  2. In Frihet, go to Invoicing → Import from Toggl
  3. Choose "Last 24 hours"
  4. Click "Import"
  5. You should see a draft invoice

If it does not appear:

  • Verify that Toggl is connected ✅
  • The hours must be logged (not drafts)
  • Refresh Frihet (F5)

Import time entries​

Frihet can automatically convert your time entries into invoice lines:

  1. Connect your Toggl account
  2. Go to the Data tab of the integration
  3. Click Import time entries
  4. Enter your hourly rate
  5. Frihet groups the entries by project and creates a draft invoice

Entries are grouped by project, summing the total hours and applying the indicated rate.

Things you can do​

Group by project​

Import a complete project for the month:

Project "App iOS":
- Week 1: 20 hours
- Week 2: 25 hours
Total: 45 hours @ €70/h = €3,150

Create a single invoice: "iOS App Development - February 2025"

Invoice by sprint​

If you work in sprints:

  1. In Toggl, each sprint in a separate project
  2. Each month, import and create an invoice per sprint
  3. Clear breakdown for the client

Rates by type of work​

Toggl: Tag "Diseño" → €80/h
Toggl: Tag "Desarrollo" → €100/h
Toggl: Tag "Consultoría" → €60/h

You can map these different rates in Frihet.

Real-time synchronization​

Work you log in Toggl today:

  • Will be available for import in Frihet tomorrow
  • If you activate automatic synchronization, it will be imported automatically

Toggl sends data once a day (usually at 3 am UTC).

Edit after import​

After importing hours:

  1. The invoice is in "Draft" status
  2. You can edit:
    • Concept
    • Hourly rate
    • Add/remove lines
    • Change client
  3. When it is correct, confirm the invoice

The original hours in Toggl are not affected — you can freely edit the invoice.

Delete an import​

If you imported by mistake:

  1. Find the invoice in Invoicing → Invoices
  2. If it is still "Draft", you can Delete
  3. The hours in Toggl remain there, unchanged

If you have already confirmed it as an invoice, you can:

  • Mark it as "Cancelled"
  • Or create a credit note

Limits and restrictions​

  • Maximum 90 days of history in an import
  • 10 simultaneous imports (should not affect you)
  • No deletion synchronization — If you delete an hour in Toggl, the invoice in Frihet remains

Troubleshooting​

"I don't see my hours in Toggl"​

  • Verify that it is connected ✅
  • The hours must be logged (not drafts)
  • Wait 24h after logging in Toggl

"Can I change the rate after invoicing?"​

Yes. Edit the invoice:

  1. Invoicing → open the invoice
  2. Change hourly rate
  3. It recalculates automatically
  4. Save changes

"What happens if I change the API Key?"​

Disconnect and reconnect:

  1. Settings → Integrations → Toggl
  2. Disconnect
  3. Enter new API Key
  4. Connect

Already created invoices remain unchanged.

Next steps​

Previous: Shopify​