How to connect Toggl Track or Clockify to Zendesk

By Jake Marsh · Updated

To connect Clockify to Zendesk, generate an API key under Preferences > Advanced > Manage API keys, copy your workspace id from the address bar of Workspace settings, and paste both into Meterwell's Clockify API key and Clockify workspace id, with your Clockify region. For Toggl Track, copy the API token from Profile settings, run it through the encoder in the Meterwell sidebar, and paste the result into Toggl Track API token (encoded).

Toggl Track or Clockify: what differs

Toggl TrackClockify
CredentialAPI token from Profile settingsAPI key from Preferences > Advanced > Manage API keys
Also neededWorkspace id (the number in the address bar of Settings)Workspace id and data region
Whose timesheetAlways the token's user, with "(for Agent Name)" in the descriptionEach agent's own, when the key belongs to a workspace admin
Billable flagSet on the entrySet on the entry
TaskOptionalOptional
Edit billable from ZendeskYesYes

Connect Clockify

  1. Generate the key. In Clockify, open Preferences > Advanced > Manage API keys > Generate new. Use a workspace admin's account so entries land on each agent's own timesheet.
  2. Copy the workspace id from the address bar of Workspace settings.
  3. Note the region. If your data isn't in the default region, pick it in Clockify region: global, euc1, use2, euw2 or apse2.
  4. Paste them into Meterwell. Set Time tool to clockify and fill in Clockify API key and Clockify workspace id.

Workspaces on a subdomain need a key made for that workspace, which Clockify's API documentation also notes.

Connect Toggl Track

  1. Copy the API token from Profile settings > API Token. Many teams use a dedicated billing login for this, because every entry is made as that user.
  2. Copy the workspace id, the number in the address bar of Settings, into Toggl Track workspace id.
  3. Encode the token. Toggl Track only accepts the token as Basic auth. Finish the install, open any ticket as an admin, paste the token into the encoder in the Meterwell sidebar (under Admin) and copy the value it shows. The encoder runs in your browser only.
  4. Paste the encoded value into Toggl Track API token (encoded), and set Time tool to toggl.

Mind Toggl's hourly API limit

Toggl limits API calls per user per hour: 30 on Free, 240 on Starter and 600 on Premium. The quota is shared by every integration using that token. Meterwell only reads Toggl when it sends or when you ask, so sent entries appear after you click Show live from Toggl Track. If you see "API limit used up", wait and try again.

Check it works

Open a ticket as an admin and click Check the Toggl Track connection (or Check the Clockify connection). It confirms the token, the workspace, how many projects it sees and whether Zendesk's Time Tracking app was found. Then map an organization with Choose a project and solve a test ticket with some tracked time.

Errors and fixes

MessageFix
"did not accept the token"Create a new token. For Toggl Track, paste the encoded value, not the raw token
"No project for this ticket"Map the organization, set a Default project, or pick one for the ticket
"API limit used up"Toggl's hourly quota is used up; wait and try again
"Locked"The entry is approved or invoiced in your tool; change it there

What it costs

Meterwell costs $100 a month per Zendesk account on Team (up to 12 agents and admins) or $9 per agent per month on Scale (13 or more), with every feature and all three tools on both. There's a 14-day trial with a card, billed monthly by Zendesk. Your Toggl Track or Clockify plan is separate. Full settings: the Meterwell setup guide.

Meterwell

Time to Harvest, Toggl or Clockify: send what agents track in Zendesk, mapped to client and project. From $100 a month per Zendesk account.


Questions

Where do I find my Clockify API key?

In Clockify under Preferences > Advanced > Manage API keys, then Generate new.

Why are all Toggl Track entries under one person?

Toggl Track has no way for an integration to post for teammates, so entries are made as the token's user and the agent's name goes in the description.

Is my token visible to agents?

No. Tokens are Zendesk secure settings. Zendesk adds them to requests on the way to your tool's API, so they never reach an agent's browser.

Does it work with a Clockify workspace in the EU?

Yes. Set Clockify region to your data region, such as euc1.


More Meterwell guides


More Zendesk guides