Skip to main content

Clockify

Available

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

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

What is it for?​

With Clockify integrated:

  • Import hours — Bring your time entries into Frihet
  • Create automatic invoices — Convert time into money
  • By project or client — Group as needed
  • Flexible rates — Define price/hour per client or project

Requirements​

  • Active Clockify account — With logged hours
  • Clockify API Key — For authentication
  • Frihet Pro or higher

Get your Clockify API Key​

Step 1: Open Clockify​

  1. Go to app.clockify.me
  2. Log in
  3. In the upper right corner, click on the gear icon (Settings)

Step 2: Find your API Key​

  1. In Settings, go to Account
  2. Look for the "API" section
  3. You will see your API Key (a long token)
  4. Click on "Copy" to copy
  5. Store this token in a safe place (do not share it)

Connect Clockify to Frihet​

Step 1: Open Frihet​

  1. Go to Settings → Integrations
  2. Find Clockify
  3. Click on Connect

Step 2: Enter API Key​

  1. Paste the Clockify token
  2. Click on Verify connection
  3. If successful: "✅ Connected"

Step 3: Configure projects​

  1. Choose which projects to import:

    • All projects ✅
    • Only specific projects ⚪

  2. Set default rate:

    • Example: €55/hour
    • Changeable per client later

  3. Save

Import hours​

Manual import​

  1. Go to Invoicing → Import from Clockify
  2. Select date range:
    • "This month"
    • "Last 2 weeks"
    • "Custom"
  3. Choose projects
  4. Click on "Import"
  5. Invoices are created in "Draft" status

Automatic synchronization​

If you enable it:

  1. Each night, Frihet automatically imports your hours
  2. Groups by client/project
  3. Creates invoice drafts
  4. You confirm when ready

Practical example​

In Clockify​

Proyecto: Sitio Web
Cliente: Empresa ABC
- Lunes 3 feb: 6 horas (Desarrollo frontend)
- Miércoles 5 feb: 4 horas (Backend)
Total: 10 horas

Proyecto: Consultoría
Cliente: Juan Martínez
- Jueves 6 feb: 3 horas (Auditoría)
Total: 3 horas

In Frihet (after importing)​

Invoice #1001 - Empresa ABC

Concept: Website Development
- 6h (frontend) @ €55 = €330
- 4h (backend) @ €55 = €220
Subtotal: €550
Tax (21%): €115,50
Total: €665,50

Details:
- 3 Feb: 6h Frontend development
- 5 Feb: 4h Backend

Invoice #1002 - Juan Martínez

Concept: Technical Audit
- 3h @ €55 = €165
Subtotal: €165
Tax (21%): €34,65
Total: €199,65

Details:
- 6 Feb: 3h Audit

Custom rates​

By client​

  1. Go to Clients → open client
  2. In "Clockify Rate", enter your rate
  3. Future imports will use that rate

Example:

Empresa ABC: €75/h (cliente importante)
Juan Martínez: €55/h (tarifa estándar)

By project​

Edit the invoice before confirming:

  1. It's imported with the default rate
  2. You manually change the rate
  3. It recalculates automatically

Group hours​

By project​

If you have multiple projects for the same client:

  1. You import "Project A" → Separate invoice
  2. You import "Project B" → Separate invoice
  3. Or combine both into one invoice

By period​

Semana 1 (1-7 feb) → Factura semanal
Semana 2 (8-14 feb) → Otra factura

Or group the entire month into one large invoice.

Task descriptions​

If you use task descriptions in Clockify:

Clockify:
- 09:00-11:00 "Diseño mockups" (2h)
- 13:00-15:30 "Integración API" (2.5h)

Frihet imports:

Invoice:
- Mockup design: 2h @ €55 = €110
- API integration: 2.5h @ €55 = €137.50
Total: €247.50

Each line is editable before confirming.

Project and client mapping​

Automatic​

Clockify: "Client XYZ" → Frihet: Client "Client XYZ"

If it doesn't exist, Frihet creates it.

Manual​

To map a project to another client:

  1. Settings → Integrations → Clockify → Mapping
  2. For each project, assign a Frihet client
  3. Save

Example:

Proyecto Clockify "App Q1"
→ Asignar a cliente Frihet "Startup Tech"

Configure automatic synchronization​

If you want it to import automatically every night:

  1. Go to Settings → Integrations → Clockify
  2. Enable "Automatic synchronization"
  3. Choose synchronization time (recommended: 11pm)
  4. Save

Every night:

  • Frihet imports your hours
  • Creates invoice drafts
  • You confirm when you want

Test the integration​

Test import​

  1. In Clockify, log an entry: "Test entry" (1h)
  2. In Frihet, Invoicing → Import from Clockify
  3. Choose "Last 24 hours"
  4. Click on "Import"
  5. You should see an invoice draft

If it doesn't work:

  • Verify that Clockify is connected ✅
  • Hours must be "completed" (not paused)
  • Wait 5 minutes
  • Reload Frihet (F5)

Edits after importing​

The invoice arrives in "Draft" status. You can:

  • ✏️ Edit concept
  • ✏️ Change rate/hour
  • ✏️ Add/remove lines
  • ✏️ Change client
  • ✏️ Adjust tax

Changes in Clockify do not affect the Frihet invoice.

Import time entries​

Frihet can automatically convert your time entries into invoice lines:

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

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

Comparison: Clockify vs Toggl​

FeatureClockifyToggl
APISí ✅Sí ✅
Rate/hour€55 recomendado€60 recomendado
Task descriptionSíSí
TeamsSíSí
CostGratuito o €99/añoGratuito o €108/año

Recommendation: Use the one you already have. Both work equally well with Frihet.

Limitations​

  • Maximum 90 days per import (to avoid overload)
  • No bidirectional synchronization — Only Clockify → Frihet
  • API Key valid indefinitely — Until you revoke it

Troubleshooting​

"Does not connect with Clockify"​

  • Verify that the token is correct (copy it again)
  • Confirm that your Clockify account is active
  • Try disconnecting and reconnecting

"I see hours in Clockify but not in Frihet"​

  • Hours must be "completed", not paused
  • Clockify updates data every 24h, Frihet synchronizes every 15 minutes
  • Reload Frihet

"Can I switch from Toggl to Clockify?"​

Yes. The steps:

  1. Disconnect Toggl: Settings → Integrations → Toggl → Disconnect
  2. Connect Clockify: Settings → Integrations → Clockify → Connect
  3. Already created invoices remain the same

"Do I import 6 months of history?"​

Yes, but in multiple imports:

  1. Import 3 months (e.g., January-March)
  2. Confirm the invoices
  3. Import another 3 months
  4. This way the history is not mixed up

Next steps​

Previous: Toggl Track