API docs / Setup

Toggl Track

Send Toggl Track time entries to Equity Matrix as time contributions, through Zapier or Make.

Each Toggl Track time entry becomes a TIME contribution for the person who tracked it.

Choose which entries to send

If you track time in Toggl Track for other companies or clients too, only send the entries that belong to this organization. Pick the right workspace in the trigger, then filter on the entry’s project, client or tag:

  • Zapier: add a Filter by Zapier step right after the trigger.
  • Make: set a filter on the link between Watch Time Entries and the HTTP module.

A tag like equity works well if you want people to choose, entry by entry, what counts. If you’re in more than one Equity Matrix organization, build one Zap or scenario per organization, each with its own API key and filter.

Field mapping

Toggl TrackContribution
The user’s emailmemberEmail
Duration, converted from seconds to hoursvalue
Start datedate
Descriptiondescription
toggl:time_entry:{id}externalId

Every entry is sent with "type": "TIME". Toggl Track reports duration in seconds, so divide by 3,600 and round to 2 decimal places. In Zapier, use a Formatter → Numbers step. In Make, use a math function in the field mapping.

With Make (new and edited entries)

  1. Start with Toggl Track → Watch Time Entries. It picks up new and edited entries.
  2. Add HTTP → Make a request, set up as in Connect any tool with Zapier or Make, sending the mapped contribution.

Because each entry keeps the same externalId, an edited entry updates its contribution. Deleting an entry in Toggl Track isn’t synced, so delete the contribution in Equity Matrix too.

With Zapier (new entries)

  1. Start with Toggl Track → New Time Entry.
  2. Add Webhooks by Zapier → Custom Request, set up as in Connect any tool with Zapier or Make.

Webhooks by Zapier needs a paid Zapier plan. This Zap only sends new entries, so edits in Toggl Track won’t sync. Use Make if your team edits entries after logging them.

Entries that won’t sync

  • Running timers. A running entry has no finished duration yet. Only send entries that have stopped, with a duration of more than 0. Add a filter step for this.
  • A user whose email doesn’t match a member in Equity Matrix. If the trigger doesn’t include the user’s email, add a lookup table step that maps each Toggl Track user to their Equity Matrix email.
  • A member with no hourly rate, or a description over 500 characters.

These fail with a 422, and show as the key’s last error on the API Keys page.