> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Toggl

> How to set up the Toggl connector, plus the actions and events that are available.

![Toggl](https://stackone-logos.com/api/toggle/filled/svg)

v2.2.0[See changelog](https://docs.stackone.com/connectors/toggl/changelog.md)

[92 actions](#actions) · [29 events](#events) · 2 auth methods

IAM
Time Tracking

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [API Token · Connector Profile](https://docs.stackone.com/connectors/toggl/guides/connector-profile/api-token.md)

> [card] [Basic Auth · Connector Profile](https://docs.stackone.com/connectors/toggl/guides/connector-profile/basic-auth.md)
>
> Uses the email address and password you sign in to Toggl Track with, sent as HTTP Basic credentials. Access matches that...

Optionally, configure receiving Events for Toggl into StackOne.

> [card] [Webhooks setup](https://docs.stackone.com/connectors/toggl/guides/webhook-setup.md)

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [API Token · Link Account](https://docs.stackone.com/connectors/toggl/guides/link-account/api-token.md)

> [card] [Basic Auth · Link Account](https://docs.stackone.com/connectors/toggl/guides/link-account/basic-auth.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Authentication type

Select all
|
Clear

API Token

Basic Auth

No auth methods found

92 actions

ActionDescription

Get Current User`toggl_get_me`

Retrieve the profile of the currently authenticated user. For fetching resource lists (projects, tags, tasks, clients, r...

Update Current User`toggl_update_me`

Update profile details for the currently authenticated user.

Get My Clients`toggl_get_me_clients`

Retrieve all clients accessible to the current user.

Get My Features`toggl_get_me_features`

Retrieve enabled features for the current user across workspaces.

Get My Location`toggl_get_me_location`

Retrieve the current user's last known IP-based location.

Get My Organizations`toggl_get_me_organizations`

Retrieve all organizations the current user belongs to.

Get My Projects`toggl_get_me_projects`

Retrieve all projects accessible to the current user in a single response. Use get\_me\_projects\_paginated instead when de...

Get My Projects (Paginated)`toggl_get_me_projects_paginated`

Retrieve projects accessible to the current user with cursor-based pagination.

Get My API Quota`toggl_get_me_quota`

Retrieve API quota usage for the current user across all organizations.

Get My Tags`toggl_get_me_tags`

Retrieve all tags accessible to the current user.

Get My Tasks`toggl_get_me_tasks`

Retrieve tasks from projects the current user is participating in.

Get My Track Reminders`toggl_get_me_track_reminders`

Retrieve track reminders configured for the current user.

Get My Web Timer`toggl_get_me_web_timer`

Retrieve the current user's web timer state.

Create Organization`toggl_create_organization`

Create a new organization with a single workspace.

Get Organization`toggl_get_organization`

Retrieve data for a specific organization by its ID.

Update Organization`toggl_update_organization`

Update the name of an existing organization.

List Organization Users`toggl_list_organization_users`

Retrieve a paginated list of users in an organization.

Patch Organization Users`toggl_patch_organization_users`

Bulk-delete users from an organization entirely, removing them from all workspaces and the org. Use patch\_organization\_w\...

Leave Organization`toggl_leave_organization`

Leave an organization, removing the current user's account from the org.

Update Organization User`toggl_update_organization_user`

Update details for a single user within an organization.

Get Organization Workspaces Statistics`toggl_get_organization_workspaces_statistics`

Retrieve statistics for all workspaces in an organization.

List Organization Groups`toggl_list_organization_groups`

Retrieve all groups in an organization with user and workspace assignments.

Create Group`toggl_create_group`

Create a new group in an organization.

Update Group`toggl_update_group`

Edit an existing group in an organization.

Delete Group`toggl_delete_group`

Delete a group from an organization.

Patch Group`toggl_patch_group`

Apply patch operations to add or remove users and workspaces from a group. Use list\_organization\_groups first to obtain...

List Workspace Groups`toggl_list_workspace_groups`

Retrieve all groups in a workspace within an organization.

List Project Groups`toggl_list_project_groups`

Retrieve groups assigned to projects in a workspace.

Add Project Group`toggl_add_project_group`

Assign a group to a project in a workspace.

Delete Project Group`toggl_delete_project_group`

Remove a group from a project in a workspace.

List Workspaces`toggl_list_workspaces`

Retrieve all workspaces accessible to the current user.

Get Workspace`toggl_get_workspace`

Retrieve details for a specific workspace by its ID.

Create Workspace`toggl_create_workspace`

Create a new workspace within an organization.

Update Workspace`toggl_update_workspace`

Update settings for a specific workspace.

Get Workspace Statistics`toggl_get_workspace_statistics`

Retrieve statistics for a workspace including admin list, member count, and group count.

List Workspace Users`toggl_list_workspace_users`

Retrieves workspace-user records from the /workspace\_users endpoint, which contains role assignments and permission flag...

Get Workspace Users`toggl_get_workspace_users`

Retrieves basic user profiles from the /users endpoint, returning display name, email, and active/inactive status. Use t...

Update Workspace User Settings`toggl_update_workspace_user_settings`

Update settings for a workspace-user membership.

Delete Workspace User`toggl_delete_workspace_user`

Remove a single user from a workspace by their workspace-user record ID. Use this for individual removals via the direct...

List Organization Workspace Users`toggl_list_organization_workspace_users`

Retrieve users belonging to a workspace via the organization-scoped endpoint. Use this when you have an organization\_id...

Patch Organization Workspace Users`toggl_patch_organization_workspace_users`

Remove one or more users from a workspace via the organization API while keeping them in the organization. Unlike delete...

Create Workspace Alert`toggl_create_workspace_alert`

Create a project budget or time alert for a workspace.

Delete Workspace Alert`toggl_delete_workspace_alert`

Delete a specific alert from a workspace.

Create Workspace Rate`toggl_create_workspace_rate`

Create a new billable or labor rate for a workspace entity.

Get Workspace Rates`toggl_get_workspace_rates`

Retrieve rates for a specific entity level in a workspace.

List Workspace Track Reminders`toggl_list_workspace_track_reminders`

Retrieve all tracking reminders configured for a workspace.

Create Workspace Track Reminder`toggl_create_workspace_track_reminder`

Create a tracking reminder for a workspace.

Update Workspace Track Reminder`toggl_update_workspace_track_reminder`

Update an existing tracking reminder for a workspace.

Delete Workspace Track Reminder`toggl_delete_workspace_track_reminder`

Delete a tracking reminder from a workspace.

List Time Entries`toggl_list_time_entries`

Retrieve the latest time entries for the current user.

Get Current Time Entry`toggl_get_current_time_entry`

Retrieve the currently running time entry for the authenticated user.

Get Time Entry`toggl_get_time_entry`

Retrieve a specific time entry by its ID. Use list\_time\_entries first to obtain the time\_entry\_id.

Create Time Entry`toggl_create_time_entry`

Create a new time entry in a workspace.

Update Time Entry`toggl_update_time_entry`

Update an existing time entry in a workspace.

Bulk Edit Time Entries`toggl_bulk_edit_time_entries`

Apply bulk patch operations to multiple time entries in a workspace.

Delete Time Entry`toggl_delete_time_entry`

Delete a time entry from a workspace.

Stop Time Entry`toggl_stop_time_entry`

Stop a currently running time entry. Call get\_current\_time\_entry first to obtain the workspace\_id and time\_entry\_id of t...

List Projects`toggl_list_projects`

Retrieve all projects in a workspace.

Get Project`toggl_get_project`

Retrieve a specific project by its ID.

Create Project`toggl_create_project`

Create a new project in a workspace.

Update Project`toggl_update_project`

Update an existing project in a workspace.

Delete Project`toggl_delete_project`

Delete a project from a workspace.

Bulk Edit Projects`toggl_bulk_edit_projects`

Apply bulk edits to multiple projects in a workspace.

List Project Users`toggl_list_project_users`

Retrieve all project user memberships in a workspace.

Add Project User`toggl_add_project_user`

Add a user to a project in a workspace.

Patch Project Users`toggl_patch_project_users`

Apply bulk patch operations to multiple project-user memberships.

Update Project User`toggl_update_project_user`

Update a project-user membership in a workspace.

Delete Project User`toggl_delete_project_user`

Remove a user from a project in a workspace.

List Clients`toggl_list_clients`

Retrieve all clients in a workspace.

Get Client`toggl_get_client`

Retrieve a specific client by its ID. Use list\_clients first to obtain the client\_id.

Create Client`toggl_create_client`

Create a new client in a workspace.

Update Client`toggl_update_client`

Update an existing client in a workspace.

Delete Client`toggl_delete_client`

Permanently delete a client from a workspace.

Archive Client`toggl_archive_client`

Archive a client and its related projects in a workspace.

Restore Client`toggl_restore_client`

Restore an archived client and optionally its related projects.

List Tags`toggl_list_tags`

Retrieve all tags in a workspace.

Create Tag`toggl_create_tag`

Create a new tag in a workspace.

Update Tag`toggl_update_tag`

Update the name of an existing tag in a workspace.

Delete Tag`toggl_delete_tag`

Delete a tag from a workspace.

List Workspace Tasks`toggl_list_workspace_tasks`

Retrieve all tasks across a workspace with optional filtering.

List Project Tasks`toggl_list_project_tasks`

Retrieve all tasks for a specific project in a workspace.

Get Task`toggl_get_task`

Retrieve a specific task by its ID within a project. Use list\_project\_tasks first to obtain the task\_id.

Create Task`toggl_create_task`

Create a new task in a project.

Update Task`toggl_update_task`

Update an existing task in a project.

Delete Task`toggl_delete_task`

Delete a task from a project.

Patch Project Tasks`toggl_patch_project_tasks`

Apply bulk patch operations to multiple tasks in a project.

List Timesheet Setups`toggl_list_timesheet_setups`

Retrieve all timesheet approval setups for a workspace.

Create Timesheet Setup`toggl_create_timesheet_setup`

Create a new timesheet approval setup in a workspace.

Update Timesheet Setup`toggl_update_timesheet_setup`

Update an existing timesheet approval setup in a workspace. Use list\_timesheet\_setups first to obtain the setup\_id.

Delete Timesheet Setup`toggl_delete_timesheet_setup`

Delete a timesheet approval setup from a workspace.

List Timesheets`toggl_list_timesheets`

Retrieve all timesheets for a workspace with optional filtering.

Update Timesheet`toggl_update_timesheet`

Update the status of a timesheet (approve or reject). Use list\_timesheets first to obtain the setup\_id and start\_date fo...

## Events

Tags

Select all
|
Clear

Clients

Groups

Projects

Tags

Tasks

Time Entries

Timesheets

Users

Webhooks

Workspaces

No tags found

29 events

EventDescriptionTags

Webhook Ping / Validation`toggl_webhook_ping`

Handles Toggl's PING event. Echoes the validation\_code back in the response body to complete synchronous subscription va...

Webhooks

Client Created Webhook`toggl_webhook_client_created`

Processes Toggl Track client.created webhook events, fired when a client is created in the workspace.

ClientsWebhooks

Client Updated Webhook`toggl_webhook_client_updated`

Processes Toggl Track client.updated webhook events, fired when a client is updated in the workspace.

ClientsWebhooks

Client Deleted Webhook`toggl_webhook_client_deleted`

Processes Toggl Track client.deleted webhook events, fired when a client is deleted in the workspace.

ClientsWebhooks

Project Created Webhook`toggl_webhook_project_created`

Processes Toggl Track project.created webhook events, fired when a project is created in the workspace.

ProjectsWebhooks

Project Updated Webhook`toggl_webhook_project_updated`

Processes Toggl Track project.updated webhook events, fired when a project is updated in the workspace.

ProjectsWebhooks

Project Deleted Webhook`toggl_webhook_project_deleted`

Processes Toggl Track project.deleted webhook events, fired when a project is deleted in the workspace.

ProjectsWebhooks

Project Group Created Webhook`toggl_webhook_project_group_created`

Processes Toggl Track project\_group.created webhook events, fired when a project group is created in the workspace.

ProjectsGroupsWebhooks

Project Group Updated Webhook`toggl_webhook_project_group_updated`

Processes Toggl Track project\_group.updated webhook events, fired when a project group is updated in the workspace.

ProjectsGroupsWebhooks

Project Group Deleted Webhook`toggl_webhook_project_group_deleted`

Processes Toggl Track project\_group.deleted webhook events, fired when a project group is deleted in the workspace.

ProjectsGroupsWebhooks

Project User Created Webhook`toggl_webhook_project_user_created`

Processes Toggl Track project\_user.created webhook events, fired when a project user is created in the workspace.

ProjectsUsersWebhooks

Project User Updated Webhook`toggl_webhook_project_user_updated`

Processes Toggl Track project\_user.updated webhook events, fired when a project user is updated in the workspace.

ProjectsUsersWebhooks

Project User Deleted Webhook`toggl_webhook_project_user_deleted`

Processes Toggl Track project\_user.deleted webhook events, fired when a project user is deleted in the workspace.

ProjectsUsersWebhooks

Tag Created Webhook`toggl_webhook_tag_created`

Processes Toggl Track tag.created webhook events, fired when a tag is created in the workspace.

TagsWebhooks

Tag Updated Webhook`toggl_webhook_tag_updated`

Processes Toggl Track tag.updated webhook events, fired when a tag is updated in the workspace.

TagsWebhooks

Tag Deleted Webhook`toggl_webhook_tag_deleted`

Processes Toggl Track tag.deleted webhook events, fired when a tag is deleted in the workspace.

TagsWebhooks

Task Created Webhook`toggl_webhook_task_created`

Processes Toggl Track task.created webhook events, fired when a task is created in the workspace.

TasksWebhooks

Task Updated Webhook`toggl_webhook_task_updated`

Processes Toggl Track task.updated webhook events, fired when a task is updated in the workspace.

TasksWebhooks

Task Deleted Webhook`toggl_webhook_task_deleted`

Processes Toggl Track task.deleted webhook events, fired when a task is deleted in the workspace.

TasksWebhooks

Time Entry Created Webhook`toggl_webhook_time_entry_created`

Processes Toggl Track time\_entry.created webhook events, fired when a time entry is created in the workspace.

Time EntriesWebhooks

Time Entry Updated Webhook`toggl_webhook_time_entry_updated`

Processes Toggl Track time\_entry.updated webhook events, fired when a time entry is updated in the workspace.

Time EntriesWebhooks

Time Entry Deleted Webhook`toggl_webhook_time_entry_deleted`

Processes Toggl Track time\_entry.deleted webhook events, fired when a time entry is deleted in the workspace.

Time EntriesWebhooks

Timesheet Created Webhook`toggl_webhook_timesheet_created`

Processes Toggl Track timesheet.created webhook events, fired when a timesheet is created in the workspace.

TimesheetsWebhooks

Timesheet Updated Webhook`toggl_webhook_timesheet_updated`

Processes Toggl Track timesheet.updated webhook events, fired when a timesheet is updated in the workspace.

TimesheetsWebhooks

Timesheet Deleted Webhook`toggl_webhook_timesheet_deleted`

Processes Toggl Track timesheet.deleted webhook events, fired when a timesheet is deleted in the workspace.

TimesheetsWebhooks

Workspace User Created Webhook`toggl_webhook_workspace_user_created`

Processes Toggl Track workspace\_user.created webhook events, fired when a workspace user is created in the workspace.

WorkspacesUsersWebhooks

Workspace User Updated Webhook`toggl_webhook_workspace_user_updated`

Processes Toggl Track workspace\_user.updated webhook events, fired when a workspace user is updated in the workspace.

WorkspacesUsersWebhooks

Workspace User Deleted Webhook`toggl_webhook_workspace_user_deleted`

Processes Toggl Track workspace\_user.deleted webhook events, fired when a workspace user is deleted in the workspace.

WorkspacesUsersWebhooks

Workspace Updated Webhook`toggl_webhook_workspace_updated`

Processes Toggl Track workspace.updated webhook events, fired when a workspace is updated in the workspace.

WorkspacesWebhooks


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.