Skip to main content

Clockify

Connection

Frihet turns Clockify 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 Clockify.

What Frihet does​

  • Stores the Clockify credential and the workspace you pick securely:
    • Clockify API Key (stored encrypted)
  • Test connection — Frihet checks the credential by requesting your user from Clockify.
  • 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 CLK-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 Clockify: hours only flow from Clockify to Frihet.

Requirements​

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

Connect​

Step 1: get the credential in Clockify​

  1. Go to app.clockify.me and sign in.
  2. Open your profile settings and find the API section.
  3. Generate and copy your API Key.

Step 2: save it in Frihet​

  1. In Frihet, go to Integrations.
  2. Open Clockify.
  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 Clockify. 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