Time tracking: Harvest, Toggl, Clockify and Hubstaff

Connect your team's time tracker so logged hours flow into Handl automatically, ready for you to approve and invoice.

Steps

Go to Settings → Automation → Integrations and find your time tracker.
Harvest and Hubstaff: click Connect, sign in through the pop-up, and authorise Handl.
Toggl and Clockify: click Connect and paste in your API token or key when prompted. See the Toggl notes below.
Link the tracker's projects to your Handl projects. The first sync for a link starts straight away, and Handl tells you how it went.
Entries import as Pending — review and approve them in the project's Time area before they can be invoiced.

When you connect, the tile turns green and shows Connected as soon as Handl has checked your key or sign-in with the tracker. Until you link a project it reads Link a project to start importing time; nothing is imported until you do.

Connecting Toggl

Handl supports both Toggl products through the same Toggl tile.

Toggl Track: paste your API token from Profile → API Token, then choose the workspace to import from.
Toggl 2.0: paste your API key from your account settings (it starts with toggl_sk_). Handl recognises the prefix and asks for your Organization ID — the number in your Toggl address bar after you sign in to Toggl 2.0 (focus.toggl.com). Handl then finds the workspaces that key can reach and lets you pick one.

If you switch an existing Toggl connection from one product to the other, the project links from the old product are paused, because project ids differ between Toggl Track and Toggl 2.0. Link your projects again after switching.

Matching tracker users to your team

Each person's tracked time needs to be tied to a Handl team member so it carries the right rate and shows on their reports.

Toggl: Handl matches Toggl users to your active team members by email address automatically each time it syncs. If two people share an email, or no team member matches, Handl leaves that user for you to map by hand.
All trackers: if someone's time was imported before you mapped them, it is attributed to them once you map them. This only applies to entries that aren't invoiced yet and aren't waived, and it never moves time from one person to another.

Good to know

Imported time always lands as Pending first — nothing is billable until it's been approved (see "How time entries sync and get approved").
Toggl and Clockify connect with an API key rather than a sign-in pop-up, so there's nothing to reconnect if your token stays valid.
If a tracker entry is deleted in Toggl, the matching time in Handl stops being billable, unless it is already on an invoice.
Large teams on Hubstaff may see a slightly longer first sync while Handl works within Hubstaff's rate limits.
Ongoing syncs happen automatically on a schedule alongside the manual Sync now button.
If Toggl 2.0's hourly request quota is used up, the sync says so and tries again on the next run, rather than silently importing nothing.
To pull older time, open the integration in Settings → Automation → Integrations and use Import history.

FAQs

Where do I find my Toggl or Clockify API key? In your Toggl or Clockify account's own profile/integrations settings — copy it across when Handl asks for it. Toggl 2.0 keys start with toggl_sk_.

Can I choose which projects sync? Yes — you link specific external projects to specific Handl projects rather than pulling everything at once.

Will unapproved time show up on invoices? No — only entries you've approved are ever included.

Why does my Toggl tile say "Link a project to start importing time"? The connection works, but no project is linked yet. Link a project and the first import runs.