# Toggl Track

:::tip 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](https://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

- [Use Clockify as an alternative to Toggl](./clockify)
- [Automate invoices with n8n](./n8n)

---

**Previous:** [Shopify](./shopify)
---