Skip to content
Documentation
Contact
← Back to documentation
Technical Reference

Toggl Track

Toggl Track is a time tracking application that allows users to track their daily activities across different platforms.

CategoryProductivity
Authenticationcustom
Version0.1.9
Published scopes0 published scopes
Last updatedSeptember 24, 2026

Overview

Connect Toggl Track with Flows360

Toggl Track is a time tracking application that allows users to track their daily activities across different platforms.

Use the Toggl Track connector to include its declared actions and events in Flows360 workflows without duplicating the integration logic inside each consuming system. This pinned connector version currently exposes 13 actions and 7 triggers.

Available actions

  • Create Client
  • Create Project
  • Create Task
  • Create Tag
  • Create Time Entry
  • Start Time Entry
  • Stop Time Entry
  • Find User
  • Plus 5 additional declared actions.

Available triggers

  • New Client
  • New or Updated Workspace
  • New Project
  • New Task
  • New Time Entry
  • New Time Entry Started
  • Plus 1 additional declared trigger.

The capability list above is generated from the exact reviewed connector package so the public description stays aligned with the version Flows360 operates.

Technical guide

Technical reference

Package identity

  • Connector: Toggl Track
  • Package: @activepieces/piece-toggl-track@0.1.9
  • Exact artifact digest: sha256:cd5cca417e3e18d7d805dfa5bb4d486e11d418d464b7da398878c48c605a9f96
  • Runtime: Activepieces-compatible deterministic worker
  • Source: the exact reviewed Activepieces source

Authentication

SECRET TEXT. Connection values are tenant-specific and remain in the consuming Studio instance; CDK stores definitions and field metadata, not customer credential values.

Action contracts

  • Create Client (create_client), Create a new client in a workspace. Classification: read.
  • Create Project (create_project), Create a new project in a workspace. Classification: read.
  • Create Task (create_task), Create a new task under a project. Classification: read.
  • Create Tag (create_tag), Create a new tag in the workspace. Classification: read.
  • Create Time Entry (create_time_entry), Create a new time entry in a workspace. Classification: read.
  • Start Time Entry (start_time_entry), Start a new time entry (live timer). Classification: read.
  • Stop Time Entry (stop_time_entry), Stops the currently running time entry. Classification: read.
  • Find User (find_user), Find a user in a workspace by their name or email. Classification: read.
  • Find Project (find_project), Find a project in a workspace by its name. Classification: read.
  • Find Task (find_task), Find a task by name and status. Classification: read.
  • Find Client (find_client), Find a client by name or status in a workspace. Classification: read.
  • Find Tag (find_tag), Find a tag by name in a workspace. Classification: read.
  • Find Time Entry (find_time_entry), Find time entries by description. Classification: read.

Trigger contracts

  • New Client, webhook.
  • New or Updated Workspace, polling.
  • New Project, webhook.
  • New Task, webhook.
  • New Time Entry, webhook.
  • New Time Entry Started, polling.
  • New Tag, webhook.

Verification

Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.

Capability summary

Authenticationcustom
Supported objects20
Supported actions13
TriggersNone published

Authentication

Authentication method: custom

Authentication profiles

connection · custom
  • API Token Required · protected credential

Supported objects

ObjectReadWriteNotes
Create Client Yes No Create a new client in a workspace.
Create Project Yes No Create a new project in a workspace.
Create Task Yes No Create a new task under a project.
Create Tag Yes No Create a new tag in the workspace.
Create Time Entry Yes No Create a new time entry in a workspace.
Start Time Entry Yes No Start a new time entry (live timer).
Stop Time Entry Yes No Stops the currently running time entry.
Find User Yes No Find a user in a workspace by their name or email.
Find Project Yes No Find a project in a workspace by its name.
Find Task Yes No Find a task by name and status.
Find Client Yes No Find a client by name or status in a workspace.
Find Tag Yes No Find a tag by name in a workspace.
Find Time Entry Yes No Find time entries by description.
New Client Yes No webhook trigger declared by the pinned package.
New or Updated Workspace Yes No polling trigger declared by the pinned package.
New Project Yes No webhook trigger declared by the pinned package.
New Task Yes No webhook trigger declared by the pinned package.
New Time Entry Yes No webhook trigger declared by the pinned package.
New Time Entry Started Yes No polling trigger declared by the pinned package.
New Tag Yes No webhook trigger declared by the pinned package.

Supported actions

Create Client · Read

Create a new client in a workspace.

create_client · Risk: low · Retry: safe

Inputs

  • workspace_id · string · Required, The workspace to operate in.
  • name · string · Required, The name of the new client.
  • external_reference · string · Optional, External reference to link this client with external systems.
  • notes · string · Optional, Notes for the client.
Create Project · Read

Create a new project in a workspace.

create_project · Risk: low · Retry: safe

Inputs

  • workspace_id · string · Required, The workspace to operate in.
  • name · string · Required, The name of the new project.
  • client_id · string · Optional, The client to associate the project with.
  • is_private · boolean · Optional, Whether the project is private or not.
  • billable · boolean · Optional, Whether the project is billable. (Premium feature)
  • template · boolean · Optional, Whether the project is a template. (Premium feature)
  • external_reference · string · Optional, External reference to link this project with external systems.
  • color · string · Optional, Project color in hex format (e.g. #ff0000).
  • active · boolean · Optional, Whether the project is active.
  • auto_estimates · boolean · Optional, Whether estimates are based on task hours. (Premium feature)
  • estimated_hours · number · Optional, Estimated hours for the project. (Premium feature)
  • rate · number · Optional, Hourly rate for the project. (Premium feature)
  • fixed_fee · number · Optional, Project fixed fee. (Premium feature)
  • start_date · string · Optional, Start date of project timeframe (YYYY-MM-DD).
  • end_date · string · Optional, End date of project timeframe (YYYY-MM-DD).
Create Task · Read

Create a new task under a project.

create_task · Risk: low · Retry: safe

Inputs

  • workspace_id · string · Required, The workspace to operate in.
  • project_id · string · Required, The project to create the task under.
  • name · string · Required, The name of the new task.
  • estimated_seconds · number · Optional, The estimated time for the task in seconds.
  • external_reference · string · Optional, External reference to link this task with external systems.
  • active · boolean · Optional, Whether the task is active. Use false to mark as done.
  • user_id · number · Optional, Creator ID, if omitted, will use requester user ID.
Create Tag · Read

Create a new tag in the workspace.

create_tag · Risk: low · Retry: safe

Inputs

  • workspace_id · string · Required, The workspace to operate in.
  • name · string · Required, The name of the new tag.
Create Time Entry · Read

Create a new time entry in a workspace.

create_time_entry · Risk: low · Retry: safe

Inputs

  • workspace_id · string · Required, The workspace to operate in.
  • description · string · Optional
  • start · string · Required, The start time of the entry in UTC.
  • duration · number · Required, Duration of the time entry. Use a negative number (e.g., -1) to start a running timer.
  • stop · string · Optional, The stop time of the entry in UTC. Can be omitted if still running.
  • task_id · string · Optional, The task to select.
  • project_id · string · Optional, The project to associate the time entry with.
  • tags · array · Optional, Tags to associate with the time entry. You can create new tags by typing them.
  • billable · boolean · Optional, Whether the time entry is marked as billable.
  • user_id · number · Optional, Time entry creator ID. If omitted, will use requester user ID.
Start Time Entry · Read

Start a new time entry (live timer).

start_time_entry · Risk: low · Retry: safe

Inputs

  • workspace_id · string · Required, The workspace to operate in.
  • description · string · Optional
  • project_id · string · Optional, The project to associate the time entry with.
  • tags · array · Optional, Tags to associate with the time entry. You can create new tags by typing them.
  • billable · boolean · Optional, Whether the time entry is marked as billable.
  • task_id · string · Optional, The task to select.
Stop Time Entry · Read

Stops the currently running time entry.

stop_time_entry · Risk: low · Retry: safe

Inputs

  • workspace_id · string · Required, The workspace to operate in.
Find User · Read

Find a user in a workspace by their name or email.

find_user · Risk: low · Retry: safe

Inputs

  • workspace_id · string · Required, The workspace to operate in.
  • organization_id · string · Required, The organization to operate in.
  • search_term · string · Optional, The name or email of the user to find.
  • active · boolean · Optional, Return only active users.
  • page · number · Optional, Page number for pagination.
  • per_page · number · Optional, Number of items per page.
Find Project · Read

Find a project in a workspace by its name.

find_project · Risk: low · Retry: safe

Inputs

  • workspace_id · string · Required, The workspace to operate in.
  • name · string · Optional, The name of the project to find.
  • active · string · Optional, Return active, inactive, or both types of projects.
  • billable · boolean · Optional, Return only billable projects.
  • only_me · boolean · Optional, Get only projects assigned to the current user.
  • only_templates · boolean · Optional, Return only template projects.
  • page · number · Optional, Page number for pagination.
  • per_page · number · Optional, Number of items per page (max 200).
Find Task · Read

Find a task by name and status.

find_task · Risk: low · Retry: safe

Inputs

  • workspace_id · string · Required, The workspace to operate in.
  • search · string · Optional, Search by task name.
  • project_id · number · Optional, Filter by project ID.
  • active · string · Optional, Filter by active state.
  • page · number · Optional, Page number for pagination.
  • per_page · number · Optional, Number of items per page (default 50).
  • sort_field · string · Optional, Field used for sorting.
  • sort_order · string · Optional, Sort order.
  • start_date · string · Optional, Smallest boundary date (YYYY-MM-DD).
  • end_date · string · Optional, Biggest boundary date (YYYY-MM-DD).
Find Client · Read

Find a client by name or status in a workspace.

find_client · Risk: low · Retry: safe

Inputs

  • workspace_id · string · Required, The workspace to operate in.
  • name · string · Optional, The name of the client to find (case-insensitive).
  • status · string · Optional, Filter clients by their status.
Find Tag · Read

Find a tag by name in a workspace.

find_tag · Risk: low · Retry: safe

Inputs

  • workspace_id · string · Required, The workspace to operate in.
  • search · string · Optional, Search by tag name.
  • page · number · Optional, Page number for pagination.
  • per_page · number · Optional, Number of items per page.
Find Time Entry · Read

Find time entries by description.

find_time_entry · Risk: low · Retry: safe

Inputs

  • description · string · Optional, Search for time entries containing this text in description.
  • start_date · string · Optional, Get entries from start_date (YYYY-MM-DD or RFC3339 format).
  • end_date · string · Optional, Get entries until end_date (YYYY-MM-DD or RFC3339 format).
  • before · string · Optional, Get entries before given date (YYYY-MM-DD or RFC3339 format).
  • since · number · Optional, Get entries modified since this UNIX timestamp.
  • meta · boolean · Optional, Should the response contain data for meta entities.
  • include_sharing · boolean · Optional, Include sharing details in the response.

Setup

Setup

  1. Add the Toggl Track connector to the workflow in the target Flows360 Studio instance.
  2. Create or select the tenant-specific connection required by the connector. Connection secrets remain in the Studio connection boundary and are not copied into CDK documentation.
  3. Provide the connection fields declared by the pinned package:
  • No provider credential fields are declared by the pinned package.
  1. Select the required action or trigger and complete its declared input fields. Required and optional inputs are defined by the exact package schema.
  2. Test the workflow in the appropriate environment before enabling production scheduling or event delivery.

Limitations

Limitations and operational notes

  • This content describes @activepieces/piece-toggl-track@0.1.9; provider behaviour can change independently and should be revalidated when the provider or connector version changes.
  • Only the 13 actions and 7 triggers declared by this pinned package are represented here.
  • Tenant credentials and connection values are not stored in the public connector record.
  • Provider-side permissions, account entitlements, quotas and rate limits remain subject to the connected provider account and are not inferred when the package does not declare them.
  • Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.

Troubleshooting

Why canu2019t the connector authenticate?

Check the tenant connection in Studio and confirm every required Toggl Track connection field is present. Re-authorise OAuth-based connections if the provider token or consent has expired. Do not place credential values in CDK content or logs.

Why is an action or trigger unavailable?

Confirm that the workflow is using @activepieces/piece-toggl-track@0.1.9 and compare the requested capability with the declared action and trigger list for this version. A capability that is not declared by the pinned package should not be presented as supported.

What should I check after a provider-side change?

Revalidate authentication, required fields, action/trigger behaviour and provider documentation before publishing refreshed connector content or moving a new package version into production.

github.com