Toggl
togglToggl is a time tracking application that helps users monitor and manage their work hours efficiently.
Acciones disponibles (31)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
Create ClientTOGGL_CREATE_CLIENTAcciónTool to create a new client in a workspace. use when you need to add a client to a workspace after workspace setup.
TOGGL_CREATE_CLIENTAcciónTool to create a new client in a workspace. use when you need to add a client to a workspace after workspace setup.
Parámetros de entrada
namestringObligatorioName of the client to create
workspace_idintegerObligatorioID of the workspace where the client will be created
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create OrganizationTOGGL_CREATE_ORGANIZATIONAcciónTool to create a new organization with a default workspace. use when initializing a werklog organization and workspace in one step.
TOGGL_CREATE_ORGANIZATIONAcciónTool to create a new organization with a default workspace. use when initializing a werklog organization and workspace in one step.
Parámetros de entrada
namestringObligatorioName of the new organization; 1–140 characters.
workspace_namestringObligatorioName of the default workspace; 1–140 characters.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create ProjectTOGGL_CREATE_PROJECTAcciónTool to create a new project in a workspace. use after confirming workspace id and desired project parameters.
TOGGL_CREATE_PROJECTAcciónTool to create a new project in a workspace. use after confirming workspace id and desired project parameters.
Parámetros de entrada
namestringObligatorioName of the new project
colorintegerProject color code as integer
activebooleanWhether the project is active (true) or archived (false)
billablebooleanDefault billable status for entries in this project
currencystringISO currency code for fixed fee and hourly rate
client_idintegerID of the client the project belongs to
fixed_feenumberFixed-price fee for this project in chosen currency
is_privatebooleanWhether the project is private (true) or public (false)
hourly_ratenumberDefault hourly rate for this project in chosen currency
is_templatebooleanMark this project as a template for future use
template_idintegerID of an existing template project to base this project on
workspace_idintegerObligatorioID of the workspace where the project will be created
estimated_hoursnumberEstimated total hours for the project
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create TagTOGGL_CREATE_TAGAcciónTool to create a new tag in a workspace. use when you need to add a tag after confirming workspace id and desired tag name.
TOGGL_CREATE_TAGAcciónTool to create a new tag in a workspace. use when you need to add a tag after confirming workspace id and desired tag name.
Parámetros de entrada
namestringObligatorioName of the new tag
client_idintegerOptional client ID to associate with the tag
workspace_idintegerObligatorioID of the workspace where the tag will be created
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create Time EntryTOGGL_CREATE_TIME_ENTRYAcciónTool to create a new time entry in the specified workspace. use when you have workspace id, start time, and client name ready.
TOGGL_CREATE_TIME_ENTRYAcciónTool to create a new time entry in the specified workspace. use when you have workspace id, start time, and client name ready.
Parámetros de entrada
stopstringISO 8601 timestamp when the entry stopped; omit to leave running
tagsstring[]List of tags to attach to the entry
startstringObligatorioISO 8601 timestamp when the entry started
task_idintegerTask ID associated with the time entry
billablebooleanWhether the entry is billable
durationintegerDuration in seconds; omit for running entries
project_idintegerProject ID to associate the entry with
descriptionstringDescription of the time entry
created_withstringObligatorioName of the client application creating this entry
workspace_idintegerObligatorioWorkspace ID where the time entry will be created
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete Toggl ClientTOGGL_DELETE_CLIENTAcciónTool to delete a client in toggl. use when you have confirmed the workspace and client ids and want to remove a client permanently.
TOGGL_DELETE_CLIENTAcciónTool to delete a client in toggl. use when you have confirmed the workspace and client ids and want to remove a client permanently.
Parámetros de entrada
client_idstringObligatorioThe ID of the client to delete.
workspace_idstringObligatorioThe ID of the workspace where the client resides.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete TagTOGGL_DELETE_TAGAcciónTool to delete a tag from a workspace. use when you need to remove an unused tag after confirming its workspace and tag ids.
TOGGL_DELETE_TAGAcciónTool to delete a tag from a workspace. use when you need to remove an unused tag after confirming its workspace and tag ids.
Parámetros de entrada
tag_idstringObligatorioThe tag's unique identifier within the workspace.
workspace_idstringObligatorioThe workspace's unique identifier.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Client DetailsTOGGL_GET_CLIENT_DETAILSAcciónTool to retrieve details of a specific client. use when you need to fetch client metadata by its id from toggl.
TOGGL_GET_CLIENT_DETAILSAcciónTool to retrieve details of a specific client. use when you need to fetch client metadata by its id from toggl.
Parámetros de entrada
client_idintegerObligatorioThe unique ID of the client to retrieve details for
workspace_idintegerObligatorioThe workspace ID the client belongs to
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Current Time EntryTOGGL_GET_CURRENT_TIME_ENTRYAcciónTool to retrieve the current running time entry for the authenticated user. use after starting the timer to fetch the active time entry.
TOGGL_GET_CURRENT_TIME_ENTRYAcciónTool to retrieve the current running time entry for the authenticated user. use after starting the timer to fetch the active time entry.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectModel representing a Toggl time entry object.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List ClientsTOGGL_GET_LIST_CLIENTSAcciónTool to retrieve a list of clients from a toggl workspace. use when you need to list all clients with optional filters.
TOGGL_GET_LIST_CLIENTSAcciónTool to retrieve a list of clients from a toggl workspace. use when you need to list all clients with optional filters.
Parámetros de entrada
pageintegerPage number for pagination (minimum is 1)
sincestringReturn clients modified after this timestamp (ISO 8601 format)
untilstringReturn clients modified before this timestamp (ISO 8601 format)
activebooleanFilter by active status. True for active clients, False for inactive.
per_pageintegerNumber of clients per page (1-200)
workspace_idintegerObligatorioThe unique ID of the workspace to list clients from
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Organization DetailsTOGGL_GET_ORGANIZATION_DETAILSAcciónTool to retrieve details of a specific organization by its id. use when you need organizational metadata after confirming the organization id.
TOGGL_GET_ORGANIZATION_DETAILSAcciónTool to retrieve details of a specific organization by its id. use when you need organizational metadata after confirming the organization id.
Parámetros de entrada
organization_idintegerObligatorioUnique ID of the organization to retrieve
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Organization GroupsTOGGL_GET_ORGANIZATION_GROUPSAcciónTool to retrieve list of groups in a specified organization. use after confirming organization id.
TOGGL_GET_ORGANIZATION_GROUPSAcciónTool to retrieve list of groups in a specified organization. use after confirming organization id.
Parámetros de entrada
organization_idintegerObligatorioUnique identifier of the organization
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Organization UsersTOGGL_GET_ORGANIZATION_USERSAcciónTool to retrieve all users in a toggl organization by organization id. use after confirming the target organization id.
TOGGL_GET_ORGANIZATION_USERSAcciónTool to retrieve all users in a toggl organization by organization id. use after confirming the target organization id.
Parámetros de entrada
organization_idintegerObligatorioThe unique ID of the organization to list users for
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Project DetailsTOGGL_GET_PROJECT_DETAILSAcciónTool to retrieve details of a specific project. use after confirming the workspace id and project id.
TOGGL_GET_PROJECT_DETAILSAcciónTool to retrieve details of a specific project. use after confirming the workspace id and project id.
Parámetros de entrada
project_idintegerObligatorioUnique identifier of the project to retrieve
workspace_idintegerObligatorioWorkspace ID the project belongs to
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get ProjectsTOGGL_GET_PROJECTSAcciónTool to retrieve a list of projects from a toggl workspace. use after confirming workspace id. returns filtered and paginated projects with optional client details.
TOGGL_GET_PROJECTSAcciónTool to retrieve a list of projects from a toggl workspace. use after confirming workspace id. returns filtered and paginated projects with optional client details.
Parámetros de entrada
pageintegerPage number for pagination (minimum is 1)
sincestringReturn projects modified after this timestamp (ISO 8601 format)
untilstringReturn projects modified before this timestamp (ISO 8601 format)
clientsbooleanInclude full client details when true
user_idintegerFilter projects visible by this user ID
page_sizeintegerNumber of projects per page (1-200)
project_idsstringComma-separated list of project IDs to filter (max 200 IDs)
workspace_idintegerObligatorioThe unique ID of the workspace to list projects from
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get TagsTOGGL_GET_TAGSAcciónTool to retrieve all tags in a toggl workspace. use after confirming the workspace id.
TOGGL_GET_TAGSAcciónTool to retrieve all tags in a toggl workspace. use after confirming the workspace id.
Parámetros de entrada
workspace_idintegerObligatorioThe ID of the workspace to retrieve tags for
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List TasksTOGGL_GET_TASKSAcciónTool to list tasks in a workspace or within a specific project.
TOGGL_GET_TASKSAcciónTool to list tasks in a workspace or within a specific project.
Parámetros de entrada
pageintegerPage number for pagination (minimum is 1)
activebooleanIf true, returns only active tasks
billablebooleanIf true, returns only billable tasks
page_sizeintegerNumber of tasks per page (1-1000)
project_idintegerFilter tasks to only those belonging to this project ID
workspace_idintegerObligatorioWorkspace ID to list tasks from
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Time EntriesTOGGL_GET_TIME_ENTRIESAcciónTool to list the latest time entries for the authenticated user. use when you need to fetch or filter your logged time entries by start date or end date.
TOGGL_GET_TIME_ENTRIESAcciónTool to list the latest time entries for the authenticated user. use when you need to fetch or filter your logged time entries by start date or end date.
Parámetros de entrada
end_datestringOnly include entries before this timestamp (ISO 8601 format)
start_datestringOnly include entries after this timestamp (ISO 8601 format)
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Time EntryTOGGL_GET_TIME_ENTRYAcciónTool to retrieve a specific time entry by its id. use when you have the entry id and need its full details.
TOGGL_GET_TIME_ENTRYAcciónTool to retrieve a specific time entry by its id. use when you have the entry id and need its full details.
Parámetros de entrada
time_entry_idintegerObligatorioThe unique ID of the time entry to retrieve
Parámetros de salida
dataobjectObligatorioThe requested time entry object
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get User ClientsTOGGL_GET_USER_CLIENTSAcciónTool to fetch the list of clients accessible by the authenticated user. use when you need to see all clients available to the current toggl user.
TOGGL_GET_USER_CLIENTSAcciónTool to fetch the list of clients accessible by the authenticated user. use when you need to see all clients available to the current toggl user.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get User PreferencesTOGGL_GET_USER_PREFERENCESAcciónTool to retrieve current user's preferences and alpha features. use when you need to access user settings for customized experiences.
TOGGL_GET_USER_PREFERENCESAcciónTool to retrieve current user's preferences and alpha features. use when you need to access user settings for customized experiences.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get User ProjectsTOGGL_GET_USER_PROJECTSAcciónTool to retrieve all projects for the authenticated user. use after authenticating to list available projects.
TOGGL_GET_USER_PROJECTSAcciónTool to retrieve all projects for the authenticated user. use after authenticating to list available projects.
Parámetros de entrada
workspace_idintegerOnly return projects for the specified workspace ID
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get User TagsTOGGL_GET_USER_TAGSAcciónTool to retrieve tags associated with the current user. use when you need to list all tags visible to your account.
TOGGL_GET_USER_TAGSAcciónTool to retrieve tags associated with the current user. use when you need to list all tags visible to your account.
Parámetros de entrada
workspace_idintegerOptional workspace ID to filter tags by a specific workspace.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get User TasksTOGGL_GET_USER_TASKSAcciónTool to retrieve tasks from projects in which the authenticated user is participating. use after authenticating to list all tasks across workspaces.
TOGGL_GET_USER_TASKSAcciónTool to retrieve tasks from projects in which the authenticated user is participating. use after authenticating to list all tasks across workspaces.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get User WorkspacesTOGGL_GET_USER_WORKSPACESAcciónTool to retrieve all workspaces the authenticated user belongs to. use when you need to list accessible workspaces before performing workspace-specific operations.
TOGGL_GET_USER_WORKSPACESAcciónTool to retrieve all workspaces the authenticated user belongs to. use when you need to list accessible workspaces before performing workspace-specific operations.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Workspace DetailsTOGGL_GET_WORKSPACE_DETAILSAcciónTool to retrieve details of a specific workspace. use when you need to fetch workspace configuration and settings by its id.
TOGGL_GET_WORKSPACE_DETAILSAcciónTool to retrieve details of a specific workspace. use when you need to fetch workspace configuration and settings by its id.
Parámetros de entrada
workspace_idintegerObligatorioUnique ID of the workspace to retrieve details for
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Workspace PreferencesTOGGL_GET_WORKSPACE_PREFERENCESAcciónTool to retrieve workspace preferences. use after confirming workspace id to inspect settings like week start, project creation rules, and time tracking options.
TOGGL_GET_WORKSPACE_PREFERENCESAcciónTool to retrieve workspace preferences. use after confirming workspace id to inspect settings like week start, project creation rules, and time tracking options.
Parámetros de entrada
workspace_idintegerObligatorioThe unique identifier of the workspace
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Workspace UsersTOGGL_GET_WORKSPACE_USERSAcciónTool to retrieve all users in a toggl workspace by workspace id. use after confirming the target workspace id.
TOGGL_GET_WORKSPACE_USERSAcciónTool to retrieve all users in a toggl workspace by workspace id. use after confirming the target workspace id.
Parámetros de entrada
workspace_idintegerObligatorioThe unique ID of the workspace to list users for
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Stop Time EntryTOGGL_PATCH_STOP_TIME_ENTRYAcciónTool to stop a running time entry in a workspace. use when a time entry needs to be ended.
TOGGL_PATCH_STOP_TIME_ENTRYAcciónTool to stop a running time entry in a workspace. use when a time entry needs to be ended.
Parámetros de entrada
workspace_idintegerObligatorioID of the workspace containing the time entry
time_entry_idintegerObligatorioID of the time entry to stop
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update TagTOGGL_PUT_UPDATE_TAGAcciónTool 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'.
TOGGL_PUT_UPDATE_TAGAcciónTool 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'.
Parámetros de entrada
namestringObligatorioNew name for the tag
tag_idintegerObligatorioNumeric ID of the tag to update
workspace_idintegerObligatorioNumeric ID of the workspace containing the tag
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update ClientTOGGL_UPDATE_CLIENTAcciónTool to update details of a specific client. use when you need to modify a client's name, notes, or other details after confirming workspace and client ids.
TOGGL_UPDATE_CLIENTAcciónTool to update details of a specific client. use when you need to modify a client's name, notes, or other details after confirming workspace and client ids.
Parámetros de entrada
widintegerWorkspace ID (must match workspace_id) if provided
namestringNew name for the client
notesstringAdditional notes for the client
client_idintegerObligatorioThe unique ID of the client to update
workspace_idintegerObligatorioThe unique ID of the workspace that owns the client
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not