TriggerToggl TrackReal-timeUpdated June 2026

How do I trigger when a Toggl timer starts?

Short answer: Drop the "Toggl Track → Timer Started" trigger on your workflow canvas, add filters if you want them, and publish. It fires within seconds of the event in Toggl Track, not on a polling schedule.

Use this trigger All 2 Toggl Track triggers

Anatomy

What this trigger looks like in a workflow.

Drop it on the canvas. Configure a couple of fields. Publish.

In the builder

Trigger

Timer Started

When the matching event happens

on timer startedwhen timer startednew timer startedwhen a timer is started in togglwatch for timer started

What this trigger returns

for the curious

You don’t need to read this. Tiny Command auto-maps every field into the visual picker so downstream nodes can pull values by clicking. We show it here for power users who want to know what’s on the wire.

{
  "id": 12345678,
  "duration": null,
  "description": "Working on project"
}

Output shape

Fields available to downstream nodes.

Every field below can be referenced by name in any action or filter that comes after this trigger.

Field	Type	Example
id	number	12345678
duration	null	null
description	string	"Working on project"

Pairs with

Drop these actions after Timer Started.

Add Labels to Message

Gmail · Email

Add Reaction

Slack · Communication

Add Sheet Tab

Google Sheets · Spreadsheets & Databases

Create Company

HubSpot · CRM & Sales

FAQ

Questions about Timer Started.

How does the Timer Started trigger work in Toggl Track?

Fires whenever a Toggl Track timer is started. Use it to update presence (set Slack status to "in focus"), kick off do-not-disturb, or log the activity start to a calendar.

Is the Timer Started trigger real-time?

Yes. Timer Started uses webhooks or push subscriptions, not polling. Your workflow fires within seconds of the event happening in Toggl Track.

What data does Timer Started return?

The full event payload from Toggl Track. The output shape table on this page lists every field, its type, and an example value so you can map fields into downstream nodes.

Can I filter Timer Started so only some events start a workflow?

Yes. Add a Filter node right after the trigger and match on any field, whether that's subject, sender, status, or anything else in the payload. Workflows only continue when the filter passes.

Do I need Toggl Track admin permissions to use Timer Started?

For most Toggl Track accounts a standard user can authorize the trigger. Some Toggl Track plans require an admin to enable third-party webhooks. Check Toggl Track's docs if the trigger fails to register.