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

Tools

Slug: TOGGL_CREATE_CLIENTTool to create a new client in a workspace. Use when you need to add a client to a workspace after workspace setup.

Input Parameters

string
required
Name of the client to create
string
Additional notes about the client
integer
required
ID of the workspace where the client will be created
string
External reference identifier for integration purposes

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_CREATE_GROUPTool to create a new group in a Toggl organization. Use when organizing users into teams and controlling access to workspaces. Groups help manage user permissions and workspace assignments at the organization level.

Input Parameters

string
required
Group name; 1-200 characters
array
List of user IDs to add to the group; must exist in the organization
array
required
List of workspace IDs to assign to the group; must exist in the organization
integer
required
Numeric ID of the organization where the group will be created

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_CREATE_INVITATIONCreate invitations for users to join a Toggl organization and its workspaces or a project. At least one email and one workspace or project invitation are required; invitation emails can optionally be skipped.

Input Parameters

array
required
List of email addresses to send invitations to. At least one email is required.
array
List of group IDs to add invited users to
boolean
Whether to skip sending invitation emails. If true, invitation URLs are generated but emails are not sent.
array
List of workspaces to invite users to. At least one workspace is required if project_invite is not specified.
object
Model representing project invitation details.
integer
required
ID of the organization to send invitations from

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_CREATE_ORGANIZATIONTool to create a new organization with a default workspace in Toggl Track. Use when initializing a new organization and workspace in one step. The authenticated user becomes the organization owner.

Input Parameters

string
required
Name of the new organization; 1–100 characters.
string
required
Name of the default workspace; 1–100 characters.

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_CREATE_PROJECTCreates a new project in a Toggl workspace. Projects are used to organize time entries and track work for specific initiatives. Required parameters: workspace_id (integer) and name (string). Optional parameters include client assignment, privacy settings, billable status, and time estimates. Note: Some features (custom colors, templates, fixed fees, hourly rates) require a premium Toggl plan.

Input Parameters

string
required
Name of the new project
number
Default hourly rate for this project in chosen currency (premium feature)
string
Project color as a hex string (e.g., ‘#FF5733’). Custom colors require a premium plan; otherwise defaults to standard color.
boolean
Whether the project is active (true) or archived (false)
boolean
Default billable status for entries in this project
string
ISO currency code for fixed fee and hourly rate
boolean
Mark this project as a template for future use (premium feature)
integer
ID of the client the project belongs to
number
Fixed-price fee for this project in chosen currency (premium feature)
boolean
Whether the project is private (true) or public (false)
integer
ID of an existing template project to base this project on
integer
required
ID of the workspace where the project will be created
integer
Estimated total hours for 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_CREATE_TAGTool to create a new tag in a workspace. Use when you need to add a tag after confirming workspace ID and desired tag name.

Input Parameters

string
required
Name of the new tag
integer
Optional client ID to associate with the tag
integer
required
ID of the workspace where the tag will be created

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_CREATE_TIME_ENTRYTool to create a new time entry in the specified workspace. Use when you have workspace ID, start time, and client name ready.

Input Parameters

string
ISO 8601 timestamp when the entry stopped; omit to leave running
array
List of tags to attach to the entry
string
required
ISO 8601 timestamp when the entry started
integer
Task ID associated with the time entry
boolean
Whether the entry is billable
integer
Duration in seconds; omit for running entries
integer
Project ID to associate the entry with
string
Description of the time entry
string
required
Name of the client application creating this entry
integer
required
Workspace ID where the time entry will be created

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_CREATE_WORKSPACES_PROJECT_USERSTool to add a user to workspace project users. Use when you need to assign a user to a project within a workspace with optional manager privileges and custom rates.

Input Parameters

number
Rate for this project user
boolean
Whether the user will be manager of the project
integer
required
User ID
number
Labor cost for this project user
integer
required
Project ID
integer
required
Numeric ID of the workspace
string ("start-today" | "override-current" | "override-all")
Mode for applying rate changes to the project user.
string ("start-today" | "override-current" | "override-all")
Mode for applying labor cost changes to the project user.

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_DELETE_CLIENTTool to delete a client in Toggl. Use when you have confirmed the workspace and client IDs and want to remove a client permanently.

Input Parameters

string
required
The ID of the client to delete.
string
required
The ID of the workspace where the client resides.

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_DELETE_GROUPTool to delete a group from a Toggl organization. Use when you need to permanently remove a group and its associated permissions. Requires organization and group IDs.

Input Parameters

integer
required
Numeric ID of the group.
integer
required
Numeric ID of the organization.

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_DELETE_PROJECT_GROUPTool to delete a project group from a Toggl workspace. Use when you need to remove a project group permanently. Requires workspace and project group IDs.

Input Parameters

integer
required
Numeric ID of the workspace containing the project group.
integer
required
Numeric ID of the project group to 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_DELETE_SUBSCRIPTIONTool to delete a webhook subscription in Toggl. Use when you want to remove an existing subscription for a specific workspace.

Input Parameters

integer
required
Numeric ID of the workspace
integer
required
Numeric ID of the subscription

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_DELETE_TAGDeletes a tag from a Toggl workspace. Requires workspace and tag IDs. Only workspace or organization administrators can delete tags. Returns success status upon deletion.

Input Parameters

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

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_DISABLE_WEEKLY_REPORTTool to disable weekly report email notifications. Use when you want to unsubscribe from weekly reports using the code provided in report emails.

Input Parameters

string
required
Weekly report unsubscribe code (typically received in weekly report emails)

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_EDIT_TIME_ENTRIESTool to bulk edit multiple time entries in a workspace using JSON Patch operations. Use when you need to update the same field(s) across multiple time entries at once (e.g., changing descriptions, billable status, or project associations). Maximum 100 time entries per request.

Input Parameters

boolean
If true, include metadata for related entities (projects, tags, etc.) in the response
array
required
Array of JSON Patch operations to apply to the specified time entries. Each operation modifies a specific field. At least one operation is required.
integer
required
Numeric ID of the workspace containing the time entries
string
required
Comma-separated list of time entry IDs to edit. Maximum 100 IDs per request. Example: ‘204301830,202700150,202687559’

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_GET_ALL_PLANSTool to retrieve all available Toggl subscription plans and their features. Use when you need to display plan options, compare plans, or check available features for different subscription tiers.

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_GET_CLIENT_DETAILSRetrieves detailed information about a specific client in Toggl Track by its client ID and workspace ID. Use this tool when you need to: - Get complete client details including name, notes, and metadata - Verify if a client exists in a workspace - Check client archive status, timestamps, or external references - Retrieve integration information for JIRA/Salesforce linked clients

Input Parameters

integer
required
The unique client ID to retrieve. Must be a positive integer. Returns 404 if client not found.
integer
required
The workspace ID where the client is located. Must be a positive integer.

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_GET_COUNTRIESTool to retrieve all countries supported by Toggl. Returns country details including tax information, default currencies, and postal code requirements. Use when you need to validate country data or retrieve country-specific settings for billing.

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_GET_COUNTRY_SUBDIVISIONSTool to retrieve all subdivisions (states, provinces, regions) for a specific country in Toggl Track. Use when you need to get geographical subdivision data for a country, such as US states or Canadian provinces.

Input Parameters

integer
required
The unique country ID to retrieve subdivisions for. Must be a positive integer. Returns 404 if country not found.

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_GET_CURRENCIESTool to retrieve the list of all currencies supported by Toggl Track. Use when you need currency codes and symbols for financial operations or display.

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_GET_CURRENT_TIME_ENTRYRetrieves the currently running time entry for the authenticated user. Returns null if no timer is active. Use this to check timer status or get details about the active time entry.

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_GET_EVENT_FILTERSRetrieve the list of supported event filters for Toggl webhooks. Use this when you need to know which event types are available for webhook subscriptions (e.g., client created, project updated, time entry deleted).

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_GET_KEYSRetrieves the current JWKS (JSON Web Key Set) keyset used to sign JWT tokens. Use this to obtain public keys for verifying JWT token signatures issued by Toggl.

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_GET_LIST_CLIENTSRetrieve a list of clients from a Toggl Track workspace with optional filtering by status and name. Use this tool to: - List all clients in a workspace - Filter clients by active/archived status - Search for clients by name (case-insensitive) - Get client details including IDs, names, timestamps, and permissions By default, only active clients are returned unless specified otherwise.

Input Parameters

string
Filter by client name (case-insensitive search). Returns all clients whose names contain this string.
string
Filter by client status: ‘active’ for active clients only, ‘archived’ for archived clients only, ‘both’ for all clients. Defaults to ‘active’ if not specified.
integer
required
The unique ID of the workspace to list clients from

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_GET_MY_LOCATIONRetrieves the authenticated user’s last known location information including city, state, country, and coordinates. Use this to determine user’s geographic location for timezone or region-specific features.

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_GET_MY_QUOTATool to retrieve API rate limit quota for the authenticated user. Use when you need to check remaining API calls before making further requests or to monitor rate limit status.

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_GET_ORGANIZATION_DETAILSRetrieves detailed information about a specific Toggl organization including subscription plan, trial status, user count, and workspace settings. Requires a valid organization ID that the authenticated user has access to.

Input Parameters

integer
required
The unique numeric identifier of the Toggl organization. Must be a positive integer. You can obtain organization IDs from workspace details or by listing user 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_GET_ORGANIZATION_GROUPSRetrieves all groups within a Toggl organization, including group members and workspace assignments. Groups are used to organize users and control access to workspaces. Returns an empty list if no groups exist in the organization.

Input Parameters

integer
required
Unique identifier of the organization

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_GET_ORGANIZATION_USERSRetrieves a list of users belonging to a Toggl organization. Returns detailed information about each user including their email, name, role, workspace memberships, and group memberships. Supports filtering by name/email, status (active/inactive/invited), admin privileges, and pagination. Use this when you need to list organization members or find specific users within an organization.

Input Parameters

integer
Page number for pagination (default: 1)
string
Search filter to match users by name or email substring
string
Comma-separated list of group IDs to filter users by group membership
integer
Number of results per page (default: 50, max: 200)
string
Sort direction for results by name: ‘asc’ or ‘desc’
string
Comma-separated list of workspace IDs to filter users by workspace membership
boolean
If true, return only users with administrative privileges
string
Comma-separated list of statuses to filter by: ‘active’, ‘inactive’, or ‘invited’
integer
required
The unique ID of the organization to list users for

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_GET_PROJECT_DETAILSTool to retrieve details of a specific project. Use after confirming the workspace ID and project ID.

Input Parameters

integer
required
Unique identifier of the project to retrieve
integer
required
Workspace ID the project belongs to

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_GET_PROJECTSTool to retrieve a list of projects from a Toggl workspace. Use after confirming workspace ID. Returns filtered and paginated projects with optional client details.

Input Parameters

integer
Page number for pagination (minimum is 1)
integer
Return projects modified after this Unix timestamp in seconds since epoch (integer). You can also provide an ISO 8601 string which will be automatically converted. Note: Toggl API only allows timestamps within the last 3 months.
integer
Return projects modified before this Unix timestamp in seconds since epoch (integer). You can also provide an ISO 8601 string which will be automatically converted.
boolean
Include full client details when true
integer
Filter projects visible by this user ID
integer
Number of projects per page (1-200)
string
Comma-separated list of project IDs to filter (max 200 IDs)
integer
required
The unique ID of the workspace to list projects from

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_GET_PROJECT_SUMMARY_REPORTLoad aggregate tracked-time and billing totals for one Toggl project.

Input Parameters

string
Inclusive report end date in YYYY-MM-DD format; must be on or after start_date.
integer
required
ID of the project whose summary is requested.
string
Inclusive report start date in YYYY-MM-DD format.
integer
required
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_GET_PUBLIC_SUBSCRIPTION_PLANSTool to retrieve all publicly available subscription plans from Toggl. Use when you need to display available pricing tiers or plan options to users.

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_GET_STATUSTool to retrieve the Toggl Webhooks server status. Use when you need to check if the webhooks service is operational before registering or managing webhook subscriptions.

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_GET_TAGSRetrieve all tags in a Toggl workspace. Returns a list of tags with their IDs, names, and metadata. Use this when you need to list available tags for categorizing time entries or when searching for a specific tag by name. Returns an empty list if the workspace has no tags.

Input Parameters

integer
required
The ID of the workspace to retrieve tags for

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_GET_TASKSTool to list tasks in a workspace or within a specific project.

Input Parameters

integer
Page number for pagination (minimum is 1)
boolean
If true, returns only active tasks
boolean
If true, returns only billable tasks
integer
Number of tasks per page (1-1000)
integer
Filter tasks to only those belonging to this project ID
integer
required
Workspace ID to list tasks from

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_GET_TIME_ENTRIESRetrieve time entries for the authenticated user with flexible filtering options. Use this tool to: - List all recent time entries (no parameters needed) - Filter entries by date range (start_date + end_date) - Get entries modified since a specific time (since parameter for syncing) - Include project/tag metadata and sharing information Returns comprehensive details including project names, tags, duration, and billable status.

Input Parameters

boolean
Include metadata for related entities (projects, tags, etc.). Provides additional context.
integer
Retrieve entries modified since this UNIX timestamp (includes deleted entries). Useful for syncing changes.
string
Filter entries with start times before this date. Format: YYYY-MM-DD or RFC3339. Alternative to end_date.
string
Filter entries with start times before or on this date. Format: YYYY-MM-DD or ISO 8601 (e.g., ‘2024-01-31’ or ‘2024-01-31T23:59:59Z’). Must be used with start_date.
string
Filter entries with start times on or after this date. Format: YYYY-MM-DD or ISO 8601 (e.g., ‘2024-01-01’ or ‘2024-01-01T00:00:00Z’). Must be used with end_date.
boolean
Include sharing information in the response (shared_with field).

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_GET_TIME_ENTRYTool to retrieve a specific time entry by its ID. Use when you have the entry ID and need its full details.

Input Parameters

integer
required
The unique ID of the time entry to retrieve

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_GET_TIMEZONE_OFFSETSTool to retrieve all available timezone offsets from Toggl. Use when you need to display timezone information or validate timezone selection for time entry operations.

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_GET_TIMEZONESTool to retrieve all available timezones supported by Toggl Track. Use when you need to validate timezone values or display available timezone options to users.

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_GET_USER_CLIENTSRetrieves all clients accessible to the authenticated user across all their workspaces. Returns a complete list of client details including workspace associations, archive status, notes, and integration information. Use this to view all clients the current user has access to without needing to specify individual workspace IDs.

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_GET_USER_PREFERENCESRetrieves the authenticated user’s preferences including timezone, date/time formats, notification settings, and enabled alpha/experimental features. Useful for understanding user display preferences or checking which optional features are available.

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_GET_USER_PROJECTSRetrieves projects for the authenticated user, with optional workspace, archive and modification-time filters. When pagination parameters are supplied, returns a page of projects.

Input Parameters

integer
Retrieve projects modified since this date using UNIX timestamp (seconds since epoch), including deleted ones
integer
Number of items per page when using pagination (default 201). When set, the paginated endpoint is used.
integer
Only return projects for the specified workspace ID
boolean
Include archived projects in the response
integer
Project ID to resume the next pagination from. Used with per_page for cursor-based pagination.

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_GET_USER_TAGSTool to retrieve tags associated with the current user. Use when you need to list all tags visible to your account across all workspaces, or to get tags that have been created/modified/deleted since a specific date for incremental syncing.

Input Parameters

integer
Optional UNIX timestamp to retrieve tags that have been created, modified, or deleted since this date. Use this for incremental syncing. Note: The timestamp cannot be older than 3 months from the current date.

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_GET_USER_TASKSRetrieve tasks from the authenticated user’s accessible Toggl workspaces without specifying workspace or project IDs. Task details can include their names, active status, estimated time, and tracked time.

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_GET_USER_WORKSPACESTool to retrieve all workspaces the authenticated user belongs to. Use when you need to list accessible workspaces before performing workspace-specific operations. Verify the correct workspace ID from the returned list before use — an incorrect workspace ID will misroute entries and skew reports.

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_GET_WORKSPACE_DETAILSRetrieves comprehensive details and settings for a specific Toggl workspace by ID. Returns workspace configuration including premium/business status, admin permissions, default settings for projects/billing, time tracking preferences, and organizational details. Use this when you need to inspect workspace properties or validate access before performing workspace-specific operations.

Input Parameters

integer
required
Unique ID of the workspace to retrieve details for

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_GET_WORKSPACE_LOGOTool to get workspace logo. Use when you need to retrieve the logo associated with a specific workspace.

Input Parameters

integer
required
Numeric ID of the workspace

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_GET_WORKSPACE_PREFERENCESRetrieves workspace preferences including the initial pricing plan and whether start/end times are hidden. Use this after obtaining a workspace ID to check workspace-level preference settings.

Input Parameters

integer
required
The unique identifier of the workspace

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_GET_WORKSPACE_USERSRetrieves all users who belong to a specific Toggl workspace. Returns user details including their name, email, admin status, and activity status. Use this to list workspace members, check user roles, or verify user access to a workspace.

Input Parameters

integer
required
The workspace ID to retrieve users from. You can get workspace IDs using the Get User Workspaces action.

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_PATCH_STOP_TIME_ENTRYTool to stop a running time entry in a workspace. Use when a time entry needs to be ended.

Input Parameters

integer
required
ID of the workspace containing the time entry
integer
required
ID of the time entry to stop Must belong to a currently running entry; stopping an already-stopped or wrong entry corrupts time-tracking history.

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_POST_ME_DISABLE_PRODUCT_EMAILSTool to disable product emails for the authenticated user using a disable code. Use when the user wants to unsubscribe from Toggl product emails using a code from an unsubscribe link.

Input Parameters

string
required
Unique disable code to unsubscribe from product emails. This code is typically obtained from email unsubscribe links and is a 32-character hexadecimal hash.

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_PUT_UPDATE_TAGTool to update an existing tag in a specified workspace. Use after confirming the workspace_id and tag_id when renaming a tag. Example: rename tag ‘urgent’ to ‘high_priority’.

Input Parameters

string
required
New name for the tag
integer
required
Numeric ID of the tag to update
integer
required
Numeric ID of the workspace containing the tag

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_SEARCH_DETAILED_REPORT_TIME_ENTRIESSearch detailed-report time entries; provide at least one report filter.

Input Parameters

boolean
Whether matching time entries should be grouped.
array
Filter by tag IDs. Use [null] for entries without tags.
boolean
Filter by billable status. This filter requires a premium workspace.
string
End date for the report in YYYY-MM-DD format; must be after start_date.
string
Legacy end-time filter sent to Toggl as endTime.
integer
First time-entry ID for provider cursor pagination.
string ("date" | "user" | "duration" | "description" | "last_update")
Field used to order report entries.
integer
Provider rounding setting; when omitted, user preferences apply.
array
Filter by task IDs. Use [null] for entries without a task.
array
Filter by user IDs.
array
Filter by workspace group IDs.
string ("ASC" | "DESC")
Ascending or descending report order.
integer
Number of report entries to return on this page.
array
Filter by client IDs. Use [null] for entries without a client.
string
Start date for the report in YYYY-MM-DD format.
string
Legacy start-time filter sent to Toggl as startTime.
string
Filter by time-entry description text.
array
Filter by project IDs. Use [null] for entries without a project.
boolean
Whether monetary amounts should be omitted from results.
integer
required
ID of the workspace whose detailed report is searched.
array
Filter by specific time-entry IDs.
boolean
Return as much related information as possible for each report entry.
integer
First timestamp for provider cursor pagination.
integer
First row number for provider cursor pagination.
integer ("0" | "1" | "5" | "6" | "10" | "12" | "15" | "30" | "60" | "240")
Rounding interval in minutes; when omitted, user preferences apply.
integer
Maximum time-entry duration in seconds for Time Audit filtering.
integer
Minimum time-entry duration in seconds for Time Audit filtering.

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_SEND_DEMO_EMAILTool to send a demo request email through Toggl’s system. Use when someone wants to request a product demo.

Input Parameters

string
required
Email address of the person requesting the demo
string
required
Phone number of the person requesting the demo
string
required
Source of the demo request (e.g., website, API, referral)
string
required
Purpose or reason for requesting the demo
string
required
Last name of the person requesting the demo
string
required
Size of the team that will use the product
string
required
First name of the person requesting the demo

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_SEND_EMAIL_CONTACTTool to send an email to a contact via Toggl’s smail service. Use when you need to send a message to a specific contact by providing their email, name, and message content.

Input Parameters

string
required
Name of the contact recipient
string
required
Email address of the recipient
string
required
Message content to send in the email

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_SEND_SMAIL_MEETTool to send an email for meet. Use when you need to send a meet invitation email to a specific recipient with a location.

Input Parameters

string
required
Email address to send the meet invitation to
string
required
Location for the meet

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_UPDATE_CLIENTUpdates an existing client in a Toggl workspace. Use this to modify a client’s name or notes. Note: The Toggl API requires the ‘name’ field when updating any client property.

Input Parameters

integer
Workspace ID (must match workspace_id if provided, rarely needed)
string
New name for the client. Note: The Toggl API requires the name field to be provided when updating any client property.
string
Additional notes or description for the client
integer
required
The unique ID of the client to update
integer
required
The unique ID of the workspace that owns 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_UPDATE_PROJECTUpdate one Toggl project; provide at least one field to change.

Input Parameters

integer
Legacy client ID to assign, or null to remove the client
string
New project name
number
Project hourly rate (premium feature)
string
Project color as a six-digit hexadecimal value
boolean
Whether the project is active rather than archived
boolean
Default billable setting for the project (premium feature)
string
Project currency (premium feature)
string
End date of the project timeframe
boolean
Whether the project is a template (premium feature)
integer
Client ID to assign, or null to remove the client
number
Project fixed fee (premium feature)
boolean
Whether the project is shared
boolean
Whether the project recurs (premium feature)
boolean
Whether the project is private
integer
required
Numeric ID of the project to update
string
Start date of the project timeframe
string
Client name to assign, or null to remove the client
integer
Template project ID, or null to clear it
integer
required
Numeric ID of the workspace that owns the project
boolean
Whether estimates are based on task hours (premium feature)
integer
Estimated project hours (premium feature)
string ("start-today" | "override-current" | "override-all")
How the hourly rate change applies to existing time entries
string
External reference associated with the project
object
Recurring project settings (premium feature)

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