> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Toggl Track

> Toggl Track is a time tracking platform for recording work, managing projects and workspaces, producing reports, and configuring webhooks.

![Toggl Track logo](https://mintcdn.com/composio-preview/IA0_SoMcsWt17HEC/images/toolkits/toggl_track.svg?fit=max\&auto=format\&n=IA0_SoMcsWt17HEC\&q=85\&s=5d8569dd181b8f569244181ab84e7730)

* **Category:** time tracking software
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 21
* **Triggers:** 0
* **Slug:** `TOGGL_TRACK`
* **Version:** 00000000\_00

## Tools

> [accordion] Bulk Update Time Entries
>
> **Slug:** `TOGGL_TRACK_BULK_UPDATE_TIME_ENTRIES`
>
> Apply 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
>
> **billable** `boolean`
>
> Replacement billable state shared by every selected time entry.
>
> **description** `string`
>
> Replacement description shared by every selected time entry.
>
> **workspace\_id** `integer` *required*
>
> Numeric ID of the workspace containing every time entry.
>
> **time\_entry\_ids** `array` *required*
>
> Unique numeric IDs of 1 to 100 time entries in the workspace. Every requested change is applied to each ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Client
>
> **Slug:** `TOGGL_TRACK_CREATE_CLIENT`
>
> Create a client in a workspace for grouping projects.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Client name.
>
> **notes** `string`
>
> Optional notes about the client.
>
> **workspace\_id** `integer` *required*
>
> Numeric workspace ID.
>
> **external\_reference** `string`
>
> Optional caller-owned external reference for the client.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Project
>
> **Slug:** `TOGGL_TRACK_CREATE_PROJECT`
>
> Create a project in a workspace for organizing time entries and tasks.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Project name.
>
> **color** `string`
>
> Project color as a six-digit hexadecimal value, including the # prefix.
>
> **active** `boolean`
>
> Whether the project starts active.
>
> **end\_date** `string`
>
> Optional project end date in YYYY-MM-DD format.
>
> **client\_id** `integer`
>
> Client ID to associate with the project.
>
> **is\_private** `boolean`
>
> Whether access to the project is restricted.
>
> **start\_date** `string`
>
> Optional project start date in YYYY-MM-DD format.
>
> **workspace\_id** `integer` *required*
>
> Numeric workspace ID, available from LIST\_WORKSPACES.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Task
>
> **Slug:** `TOGGL_TRACK_CREATE_TASK`
>
> Create a task under an active project for more specific time-entry assignment.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Task name.
>
> **user\_id** `integer`
>
> Optional user ID to assign; defaults to the requesting user.
>
> **project\_id** `integer` *required*
>
> Numeric ID of the active parent project.
>
> **workspace\_id** `integer` *required*
>
> Numeric workspace ID.
>
> **estimated\_seconds** `integer`
>
> Optional estimated task duration in seconds.
>
> **external\_reference** `string`
>
> Optional caller-owned external reference for the task.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Time Entry
>
> **Slug:** `TOGGL_TRACK_CREATE_TIME_ENTRY`
>
> Create 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
>
> **stop** `string`
>
> Stop time as an RFC3339 UTC timestamp. If duration is also supplied, it must equal stop minus start.
>
> **tags** `array`
>
> Tag names to attach; Toggl creates names that do not yet exist.
>
> **start** `string` *required*
>
> Start time as an RFC3339 UTC timestamp.
>
> **tag\_ids** `array`
>
> Existing tag IDs to attach.
>
> **task\_id** `integer`
>
> Task ID to assign. Requires project\_id, and the task must belong to that project.
>
> **billable** `boolean`
>
> Whether to mark the entry billable.
>
> **duration** `integer`
>
> Completed duration in seconds. Omit with stop to create a running entry.
>
> **project\_id** `integer`
>
> Project ID to assign, available from LIST\_WORKSPACE\_RESOURCES.
>
> **description** `string`
>
> What the tracked time is for.
>
> **workspace\_id** `integer` *required*
>
> Numeric workspace ID, available from LIST\_WORKSPACES.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Client
>
> **Slug:** `TOGGL_TRACK_DELETE_CLIENT`
>
> Permanently delete one client from a Toggl Track workspace.
>
> #### Input Parameters
>
> **client\_id** `integer` *required*
>
> Numeric ID of the client to permanently delete.
>
> **workspace\_id** `integer` *required*
>
> Numeric workspace ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Project
>
> **Slug:** `TOGGL_TRACK_DELETE_PROJECT`
>
> Delete one project while preserving its time entries by unassigning them from the project.
>
> #### Input Parameters
>
> **project\_id** `integer` *required*
>
> Numeric ID of the project to delete.
>
> **workspace\_id** `integer` *required*
>
> Numeric ID of the workspace containing the project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Task
>
> **Slug:** `TOGGL_TRACK_DELETE_TASK`
>
> Permanently delete one task from its parent project.
>
> #### Input Parameters
>
> **task\_id** `integer` *required*
>
> Numeric ID of the task to permanently delete.
>
> **project\_id** `integer` *required*
>
> Numeric ID of the task's parent project.
>
> **workspace\_id** `integer` *required*
>
> Numeric workspace ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Time Entry
>
> **Slug:** `TOGGL_TRACK_DELETE_TIME_ENTRY`
>
> Permanently delete one time entry from a workspace.
>
> #### Input Parameters
>
> **workspace\_id** `integer` *required*
>
> Numeric ID of the workspace containing the entry.
>
> **time\_entry\_id** `integer` *required*
>
> Numeric ID of the time entry to permanently delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Current Time Entry
>
> **Slug:** `TOGGL_TRACK_GET_CURRENT_TIME_ENTRY`
>
> Return the currently running time entry for the connected user, or indicate that no timer is running.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Current User
>
> **Slug:** `TOGGL_TRACK_GET_CURRENT_USER`
>
> Return the connected Toggl Track user's identity and defaults, including the default workspace ID, without exposing credentials.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Time Entry
>
> **Slug:** `TOGGL_TRACK_GET_TIME_ENTRY`
>
> Get one time entry by ID, with optional related-entity and sharing metadata.
>
> #### Input Parameters
>
> **time\_entry\_id** `integer` *required*
>
> Numeric ID of the time entry to retrieve.
>
> **include\_sharing** `boolean`
>
> Include sharing details for the time entry.
>
> **include\_metadata** `boolean`
>
> Include related project, task, client, and user display fields.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Time Entries
>
> **Slug:** `TOGGL_TRACK_LIST_TIME_ENTRIES`
>
> List the connected user's time entries in an explicit date range, optionally including related project, task, user, and sharing metadata.
>
> #### Input Parameters
>
> **end\_date** `string` *required*
>
> Inclusive end bound as YYYY-MM-DD (the end of that UTC day) or an RFC3339 timestamp; must not precede start\_date.
>
> **start\_date** `string` *required*
>
> Inclusive start bound as YYYY-MM-DD (the start of that UTC day) or an RFC3339 timestamp.
>
> **include\_sharing** `boolean`
>
> Include time-entry sharing details.
>
> **include\_metadata** `boolean`
>
> Include related project, task, client, and user display fields.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Workspace Resources
>
> **Slug:** `TOGGL_TRACK_LIST_WORKSPACE_RESOURCES`
>
> Find projects, clients, tags, or tasks in a workspace and return their IDs for time-entry and resource-management tools.
>
> #### Input Parameters
>
> **search** `string`
>
> Case-insensitive name text to match. Uses the client name filter and the provider search filter for projects, tags, and tasks.
>
> **status** `string ("active" | "archived" | "both")`
>
> Active-state filter for projects, clients, and tasks. For projects and tasks, both omits the provider active filter.
>
> **page\_size** `integer`
>
> Maximum resources to return on this page (1-200). Ignored for the unpaginated client list.
>
> **project\_id** `integer`
>
> For resource\_type=task, return tasks belonging to this project.
>
> **next\_cursor** `string`
>
> Opaque continuation cursor from a previous call with the same workspace, resource type, and filters.
>
> **workspace\_id** `integer` *required*
>
> Numeric workspace ID, available from LIST\_WORKSPACES.
>
> **resource\_type** `string ("project" | "client" | "tag" | "task")` *required*
>
> Type of workspace resource to list: project, client, tag, or task.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Workspaces
>
> **Slug:** `TOGGL_TRACK_LIST_WORKSPACES`
>
> List workspaces accessible to the connected user and return the IDs needed by workspace-scoped tools, without exposing private tokens or calendar URLs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Run Detailed Time Report
>
> **Slug:** `TOGGL_TRACK_RUN_DETAILED_TIME_REPORT`
>
> Return 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
>
> **tag\_ids** `array`
>
> Only include entries carrying these tag IDs. Use \[null] to include only entries with no tags.
>
> **end\_date** `string`
>
> Report end date in YYYY-MM-DD format; must not precede start\_date. Required when next\_cursor is omitted.
>
> **order\_by** `string ("date" | "user" | "duration" | "description" | "last_update")`
>
> Field used to order report rows.
>
> **task\_ids** `array`
>
> Only include entries assigned to these task IDs. Use \[null] to include only entries with no task.
>
> **user\_ids** `array`
>
> Only include entries created by these user IDs.
>
> **page\_size** `integer`
>
> Maximum grouped report rows to return on this page.
>
> **client\_ids** `array`
>
> Only include entries assigned to these client IDs. Use \[null] to include only entries with no client.
>
> **start\_date** `string`
>
> Report start date in YYYY-MM-DD format. Required when next\_cursor is omitted.
>
> **description** `string`
>
> Only include entries whose description matches this text.
>
> **next\_cursor** `string`
>
> Opaque cursor returned by the previous report page. When supplied, the workspace, date range, filters, ordering, and page size are restored from it.
>
> **project\_ids** `array`
>
> Only include entries assigned to these project IDs. Use \[null] to include only entries with no project.
>
> **workspace\_id** `integer`
>
> Numeric workspace ID, available from LIST\_WORKSPACES. Required when next\_cursor is omitted.
>
> **time\_entry\_ids** `array`
>
> Only include these specific time-entry IDs.
>
> **order\_direction** `string ("ASC" | "DESC")`
>
> Ascending or descending report order.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Stop Time Entry
>
> **Slug:** `TOGGL_TRACK_STOP_TIME_ENTRY`
>
> Stop a currently running time entry and return its finalized timing data.
>
> #### Input Parameters
>
> **workspace\_id** `integer` *required*
>
> Numeric ID of the workspace containing the running entry.
>
> **time\_entry\_id** `integer` *required*
>
> Numeric ID of the running time entry to stop.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Client
>
> **Slug:** `TOGGL_TRACK_UPDATE_CLIENT`
>
> Update 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
>
> **name** `string` *required*
>
> Client name required by Toggl Track for every update. Send the current name unchanged when updating only notes or the external reference.
>
> **notes** `string`
>
> Replacement client notes, or null to clear them.
>
> **client\_id** `integer` *required*
>
> Numeric ID of the client to update.
>
> **workspace\_id** `integer` *required*
>
> Numeric ID of the workspace containing the client.
>
> **external\_reference** `string`
>
> Replacement caller-owned external reference, or null to clear it.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Project
>
> **Slug:** `TOGGL_TRACK_UPDATE_PROJECT`
>
> Update a project's name, client, active state, privacy, color, or date range.
>
> #### Input Parameters
>
> **name** `string`
>
> Replacement project name.
>
> **color** `string`
>
> Replacement project color as a six-digit hexadecimal value including the # prefix.
>
> **active** `boolean`
>
> Set false to archive the project or true to reactivate it.
>
> **end\_date** `string`
>
> Replacement end date as YYYY-MM-DD, or null to clear it.
>
> **client\_id** `integer`
>
> Replacement client ID, or null to remove the client association.
>
> **is\_private** `boolean`
>
> Replacement privacy state.
>
> **project\_id** `integer` *required*
>
> Numeric ID of the project to update.
>
> **start\_date** `string`
>
> Replacement start date as YYYY-MM-DD.
>
> **workspace\_id** `integer` *required*
>
> Numeric workspace ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Task
>
> **Slug:** `TOGGL_TRACK_UPDATE_TASK`
>
> Update a task's name, completion state, estimate, assignee, or external reference.
>
> #### Input Parameters
>
> **name** `string`
>
> Replacement task name.
>
> **active** `boolean`
>
> Set false to mark the task done or true to reopen it.
>
> **task\_id** `integer` *required*
>
> Numeric ID of the task to update.
>
> **user\_id** `integer`
>
> Replacement assignee user ID, or null to unassign the task.
>
> **project\_id** `integer` *required*
>
> Numeric ID of the task's parent project.
>
> **workspace\_id** `integer` *required*
>
> Numeric workspace ID.
>
> **estimated\_seconds** `integer`
>
> Replacement estimated duration in seconds.
>
> **external\_reference** `string`
>
> Replacement caller-owned external reference, or null to clear it.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Time Entry
>
> **Slug:** `TOGGL_TRACK_UPDATE_TIME_ENTRY`
>
> Update 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
>
> **stop** `string`
>
> Replacement stop time as an RFC3339 UTC timestamp.
>
> **tags** `array`
>
> Tag names to attach or detach according to tag\_action. Adding a name that does not exist creates the tag.
>
> **start** `string`
>
> Replacement start time as an RFC3339 UTC timestamp.
>
> **tag\_ids** `array`
>
> Existing tag IDs to attach or detach according to tag\_action.
>
> **task\_id** `integer`
>
> Replacement task ID, or null to unassign the task. When changing the project assignment too, it must belong to the supplied project\_id.
>
> **billable** `boolean`
>
> Replacement billable state.
>
> **duration** `integer`
>
> Replacement duration in seconds.
>
> **project\_id** `integer`
>
> Replacement project ID, or null to unassign the project and task.
>
> **tag\_action** `string ("add" | "delete")`
>
> Use add to attach supplied tags or tag\_ids, or delete to detach them.
>
> **description** `string`
>
> Replacement time-entry description.
>
> **workspace\_id** `integer` *required*
>
> Numeric ID of the workspace containing the entry.
>
> **time\_entry\_id** `integer` *required*
>
> Numeric ID of the time entry to update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
