Skip to main content
Toggl Track logo
  • Category: time tracking software
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 21
  • Triggers: 0
  • Slug: TOGGL_TRACK
  • Version: 00000000_00

Tools

Slug: TOGGL_TRACK_BULK_UPDATE_TIME_ENTRIESApply the same description and/or billable state to 1 to 100 Toggl Track time entries in one provider-native request. Updates are non-atomic: Toggl Track performs no transaction or rollback, so some IDs can succeed while others fail; always inspect the returned per-ID success and failure lists.

Input Parameters

boolean
Replacement billable state shared by every selected time entry.
string
Replacement description shared by every selected time entry.
integer
required
Numeric ID of the workspace containing every time entry.
array
required
Unique numeric IDs of 1 to 100 time entries in the workspace. Every requested change is applied to each ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOGGL_TRACK_CREATE_CLIENTCreate a client in a workspace for grouping projects.

Input Parameters

string
required
Client name.
string
Optional notes about the client.
integer
required
Numeric workspace ID.
string
Optional caller-owned external reference for the client.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOGGL_TRACK_CREATE_PROJECTCreate a project in a workspace for organizing time entries and tasks.

Input Parameters

string
required
Project name.
string
Project color as a six-digit hexadecimal value, including the # prefix.
boolean
Whether the project starts active.
string
Optional project end date in YYYY-MM-DD format.
integer
Client ID to associate with the project.
boolean
Whether access to the project is restricted.
string
Optional project start date in YYYY-MM-DD format.
integer
required
Numeric workspace ID, available from LIST_WORKSPACES.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOGGL_TRACK_CREATE_TASKCreate a task under an active project for more specific time-entry assignment.

Input Parameters

string
required
Task name.
integer
Optional user ID to assign; defaults to the requesting user.
integer
required
Numeric ID of the active parent project.
integer
required
Numeric workspace ID.
integer
Optional estimated task duration in seconds.
string
Optional caller-owned external reference for the task.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOGGL_TRACK_CREATE_TIME_ENTRYCreate a running or completed time entry in a workspace; omit duration and stop to start a running timer. Supplying tag names may also create tags that do not yet exist.

Input Parameters

string
Stop time as an RFC3339 UTC timestamp. If duration is also supplied, it must equal stop minus start.
array
Tag names to attach; Toggl creates names that do not yet exist.
string
required
Start time as an RFC3339 UTC timestamp.
array
Existing tag IDs to attach.
integer
Task ID to assign. Requires project_id, and the task must belong to that project.
boolean
Whether to mark the entry billable.
integer
Completed duration in seconds. Omit with stop to create a running entry.
integer
Project ID to assign, available from LIST_WORKSPACE_RESOURCES.
string
What the tracked time is for.
integer
required
Numeric workspace ID, available from LIST_WORKSPACES.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOGGL_TRACK_DELETE_CLIENTPermanently delete one client from a Toggl Track workspace.

Input Parameters

integer
required
Numeric ID of the client to permanently delete.
integer
required
Numeric workspace ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOGGL_TRACK_DELETE_PROJECTDelete one project while preserving its time entries by unassigning them from the project.

Input Parameters

integer
required
Numeric ID of the project to delete.
integer
required
Numeric ID of the workspace containing the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOGGL_TRACK_DELETE_TASKPermanently delete one task from its parent project.

Input Parameters

integer
required
Numeric ID of the task to permanently delete.
integer
required
Numeric ID of the task’s parent project.
integer
required
Numeric workspace ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOGGL_TRACK_DELETE_TIME_ENTRYPermanently delete one time entry from a workspace.

Input Parameters

integer
required
Numeric ID of the workspace containing the entry.
integer
required
Numeric ID of the time entry to permanently delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOGGL_TRACK_GET_CURRENT_TIME_ENTRYReturn the currently running time entry for the connected user, or indicate that no timer is running.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOGGL_TRACK_GET_CURRENT_USERReturn the connected Toggl Track user’s identity and defaults, including the default workspace ID, without exposing credentials.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOGGL_TRACK_GET_TIME_ENTRYGet one time entry by ID, with optional related-entity and sharing metadata.

Input Parameters

integer
required
Numeric ID of the time entry to retrieve.
boolean
Include sharing details for the time entry.
boolean
Include related project, task, client, and user display fields.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOGGL_TRACK_LIST_TIME_ENTRIESList the connected user’s time entries in an explicit date range, optionally including related project, task, user, and sharing metadata.

Input Parameters

string
required
Inclusive end bound as YYYY-MM-DD (the end of that UTC day) or an RFC3339 timestamp; must not precede start_date.
string
required
Inclusive start bound as YYYY-MM-DD (the start of that UTC day) or an RFC3339 timestamp.
boolean
Include time-entry sharing details.
boolean
Include related project, task, client, and user display fields.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOGGL_TRACK_LIST_WORKSPACE_RESOURCESFind projects, clients, tags, or tasks in a workspace and return their IDs for time-entry and resource-management tools.

Input Parameters

Case-insensitive name text to match. Uses the client name filter and the provider search filter for projects, tags, and tasks.
string ("active" | "archived" | "both")
Active-state filter for projects, clients, and tasks. For projects and tasks, both omits the provider active filter.
integer
Maximum resources to return on this page (1-200). Ignored for the unpaginated client list.
integer
For resource_type=task, return tasks belonging to this project.
string
Opaque continuation cursor from a previous call with the same workspace, resource type, and filters.
integer
required
Numeric workspace ID, available from LIST_WORKSPACES.
string ("project" | "client" | "tag" | "task")
required
Type of workspace resource to list: project, client, tag, or task.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOGGL_TRACK_LIST_WORKSPACESList workspaces accessible to the connected user and return the IDs needed by workspace-scoped tools, without exposing private tokens or calendar URLs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOGGL_TRACK_RUN_DETAILED_TIME_REPORTReturn one page of detailed, grouped time-entry report rows for a workspace and date range, with an opaque cursor for the next page.

Input Parameters

array
Only include entries carrying these tag IDs. Use [null] to include only entries with no tags.
string
Report end date in YYYY-MM-DD format; must not precede start_date. Required when next_cursor is omitted.
string ("date" | "user" | "duration" | "description" | "last_update")
Field used to order report rows.
array
Only include entries assigned to these task IDs. Use [null] to include only entries with no task.
array
Only include entries created by these user IDs.
integer
Maximum grouped report rows to return on this page.
array
Only include entries assigned to these client IDs. Use [null] to include only entries with no client.
string
Report start date in YYYY-MM-DD format. Required when next_cursor is omitted.
string
Only include entries whose description matches this text.
string
Opaque cursor returned by the previous report page. When supplied, the workspace, date range, filters, ordering, and page size are restored from it.
array
Only include entries assigned to these project IDs. Use [null] to include only entries with no project.
integer
Numeric workspace ID, available from LIST_WORKSPACES. Required when next_cursor is omitted.
array
Only include these specific time-entry IDs.
string ("ASC" | "DESC")
Ascending or descending report order.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOGGL_TRACK_STOP_TIME_ENTRYStop a currently running time entry and return its finalized timing data.

Input Parameters

integer
required
Numeric ID of the workspace containing the running entry.
integer
required
Numeric ID of the running time entry to stop.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOGGL_TRACK_UPDATE_CLIENTUpdate a client’s name, notes, or external reference. Toggl Track requires the client’s name on every update, even when it is unchanged.

Input Parameters

string
required
Client name required by Toggl Track for every update. Send the current name unchanged when updating only notes or the external reference.
string
Replacement client notes, or null to clear them.
integer
required
Numeric ID of the client to update.
integer
required
Numeric ID of the workspace containing the client.
string
Replacement caller-owned external reference, or null to clear it.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOGGL_TRACK_UPDATE_PROJECTUpdate a project’s name, client, active state, privacy, color, or date range.

Input Parameters

string
Replacement project name.
string
Replacement project color as a six-digit hexadecimal value including the # prefix.
boolean
Set false to archive the project or true to reactivate it.
string
Replacement end date as YYYY-MM-DD, or null to clear it.
integer
Replacement client ID, or null to remove the client association.
boolean
Replacement privacy state.
integer
required
Numeric ID of the project to update.
string
Replacement start date as YYYY-MM-DD.
integer
required
Numeric workspace ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOGGL_TRACK_UPDATE_TASKUpdate a task’s name, completion state, estimate, assignee, or external reference.

Input Parameters

string
Replacement task name.
boolean
Set false to mark the task done or true to reopen it.
integer
required
Numeric ID of the task to update.
integer
Replacement assignee user ID, or null to unassign the task.
integer
required
Numeric ID of the task’s parent project.
integer
required
Numeric workspace ID.
integer
Replacement estimated duration in seconds.
string
Replacement caller-owned external reference, or null to clear it.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TOGGL_TRACK_UPDATE_TIME_ENTRYUpdate the timing, description, assignment, billable state, or tags of an existing time entry. Provide at least one change; changing tags requires tag_action together with tags or tag_ids. Tag effects are verified against the returned time entry so an ignored update is reported as a failure.

Input Parameters

string
Replacement stop time as an RFC3339 UTC timestamp.
array
Tag names to attach or detach according to tag_action. Adding a name that does not exist creates the tag.
string
Replacement start time as an RFC3339 UTC timestamp.
array
Existing tag IDs to attach or detach according to tag_action.
integer
Replacement task ID, or null to unassign the task. When changing the project assignment too, it must belong to the supplied project_id.
boolean
Replacement billable state.
integer
Replacement duration in seconds.
integer
Replacement project ID, or null to unassign the project and task.
string ("add" | "delete")
Use add to attach supplied tags or tag_ids, or delete to detach them.
string
Replacement time-entry description.
integer
required
Numeric ID of the workspace containing the entry.
integer
required
Numeric ID of the time entry to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not