Toggl - Apps Documentation

Requirements

Connecting Toggl takes an active account plus an API access token from your account settings — no other setup is required.[3]

Get your Toggl credentials

API TokenpasswordRequired
API token from https://track.toggl.com/profile. Sent as Basic Auth (token:api_token).
[1]
Default Workspace IDtext
Optional. Pre-fills workspace selectors on every module.
[1]

Connect Toggl in WEXTL

Log in to your WEXTL account, add the Toggl node module to your workflow, and click Create new credential.
Instant triggers use webhooks — click Create a webhook first when adding one, then create the credential.
Optional: In the Credential name field, enter a name for the credential.
Enter the authentication credentials you copied from your Toggl account, or follow the on-screen instructions to create the credential.
If prompted, authenticate your account and confirm access.
If you want to make changes to your credential in the future, follow the steps in Manage credentials →

Notes

Credentials are org-scoped; share them with teammates from the Credentials picker on any of its nodes.For detailed information on connecting an application, see Connect an application →

Toggl node modules

The list below is a reference of every Toggl node module the integration supports. You will be able to pick any of them on the workflow canvas while building automations.

Expand any Toggl node module below to see exactly what it takes in, what it returns, and what connection it needs.

Watch Time EntriesTrigger

Input fields[3]

Field	Type
WorkspaceRequired	choice

Output fields[3]

Field	Type
Event type	text
Time entry	object
ID	number
Description	text

Get ClientSearch

Input fields[3]

Field	Type
WorkspaceRequired	choice
ClientRequired	choice

Output fields[3]

Field	Type
Client ID	number
Name	text

Get Current UserSearch

Output fields[3]

Field	Type
User ID	number
Full name	text
Email	email

Get OrganizationSearch

Input fields[3]

Field	Type
OrganizationRequired	choice

Output fields[3]

Field	Type
Organization ID	number
Name	text

Get ProjectSearch

Input fields[3]

Field	Type
WorkspaceRequired	choice
ProjectRequired	choice

Output fields[3]

Field	Type
Project ID	number
Name	text

Get Time EntrySearch

Input fields[3]

Field	Type
Time entry IDRequired	text

Output fields[3]

Field	Type
Time entry ID	number
Description	text

Get WorkspaceSearch

Input fields[3]

Field	Type
WorkspaceRequired	choice

Output fields[3]

Field	Type
Workspace ID	number
Name	text

List ClientsSearch

Input fields[3]

Field	Type
WorkspaceRequired	choice
Status	choice
Limit	number

Output fields[3]

Field	Type
Client ID	number
Name	text

List GroupsSearch

Input fields[3]

Field	Type
WorkspaceRequired	choice
Limit	number

Output fields[3]

Field	Type
Group ID	number
Name	text

List My WorkspacesSearch

Input fields[3]

Field	Type
Limit	number

Output fields[3]

Field	Type
Workspace ID	number
Name	text

List OrganizationsSearch

Input fields[3]

Field	Type
Limit	number

Output fields[3]

Field	Type
Organization ID	number
Name	text

List Project UsersSearch

Input fields[3]

Field	Type
WorkspaceRequired	choice
Project IDs	text
Limit	number

Output fields[3]

Field	Type
Project user ID	number
Project ID	number

List ProjectsSearch

Input fields[3]

Field	Type
WorkspaceRequired	choice
Active	choice
Limit	number

Output fields[3]

Field	Type
Project ID	number
Name	text

List TasksSearch

Input fields[3]

Field	Type
WorkspaceRequired	choice
Project IDs	text
Limit	number

Output fields[3]

Field	Type
Task ID	number
Name	text

List Time EntriesSearch

Input fields[3]

Field	Type
Start date	date
End date	date
Limit	number

Output fields[3]

Field	Type
Time entry ID	number
Description	text
Duration (seconds)	number

List Timesheet SetupsSearch

Input fields[3]

Field	Type
WorkspaceRequired	choice
Limit	number

Output fields[3]

Field	Type
Setup ID	number
Period	text

List TimesheetsSearch

Input fields[3]

Field	Type
WorkspaceRequired	choice
Start date	date
End date	date
Limit	number

Output fields[3]

Field	Type
Status	text

List Workspace UsersSearch

Input fields[3]

Field	Type
WorkspaceRequired	choice
Limit	number

Output fields[3]

Field	Type
Workspace user ID	number
User ID	number

Create ClientAction

Input fields[3]

Field	Type
WorkspaceRequired	choice
NameRequired	text

Output fields[3]

Field	Type
Client ID	number
Name	text

Create GroupAction

Input fields[3]

Field	Type
WorkspaceRequired	choice
NameRequired	text

Output fields[3]

Field	Type
Group ID	number
Name	text

Create ProjectAction

Input fields[3]

Field	Type
WorkspaceRequired	choice
NameRequired	text
Client	choice
Private	boolean
Color	text
Active	boolean

Output fields[3]

Field	Type
Project ID	number
Name	text

Create TagAction

Input fields[3]

Field	Type
WorkspaceRequired	choice
NameRequired	text

Output fields[3]

Field	Type
Tag ID	number
Name	text

Create TaskAction

Input fields[3]

Field	Type
WorkspaceRequired	choice
ProjectRequired	choice
NameRequired	text
Active	boolean
Estimated seconds	number

Output fields[3]

Field	Type
Task ID	number
Name	text

Create Time EntryAction

Input fields[3]

Field	Type
WorkspaceRequired	choice
Description	text
StartRequired	date
Duration (seconds)Required	number
Project	choice
Tags	text
Billable	boolean

Output fields[3]

Field	Type
Time entry ID	number
Duration	number

Create Timesheet SetupAction

Input fields[3]

Field	Type
WorkspaceRequired	choice
UserRequired	choice
PeriodRequired	choice
Expected hours	number

Output fields[3]

Field	Type
Setup ID	number

Delete ClientAction

Input fields[3]

Field	Type
WorkspaceRequired	choice
ClientRequired	choice

Output fields[3]

Field	Type
Client ID	number

Delete ProjectAction

Input fields[3]

Field	Type
WorkspaceRequired	choice
ProjectRequired	choice

Output fields[3]

Field	Type
Project ID	number

Delete TaskAction

Input fields[3]

Field	Type
WorkspaceRequired	choice
ProjectRequired	choice
TaskRequired	choice

Output fields[3]

Field	Type
Task ID	number

Delete Time EntryAction

Input fields[3]

Field	Type
WorkspaceRequired	choice
Time entry IDRequired	text

Output fields[3]

Field	Type
Time entry ID	number

Make an API Calluniversal

Input fields[3]

Field	Type
URLRequired	text
MethodRequired	choice
Headers	array
Header	object
Query String	array
Parameter	object
Body	text

Output fields[3]

Field	Type
Body	text
Headers	object
Status Code	number

Start TimerAction

Input fields[3]

Field	Type
WorkspaceRequired	choice
Description	text
StartRequired	date
Project	choice
Tags	text
Billable	boolean

Output fields[3]

Field	Type
Time entry ID	number
Duration	number

Stop TimerAction

Input fields[3]

Field	Type
WorkspaceRequired	choice
Time entry IDRequired	text

Output fields[3]

Field	Type
Time entry ID	number
Duration	number

Submit ApprovalAction

Input fields[3]

Field	Type
WorkspaceRequired	choice
Timesheet setupRequired	choice
Period start dateRequired	date

Output fields[3]

Field	Type
Status	text

Update ClientAction

Input fields[3]

Field	Type
WorkspaceRequired	choice
ClientRequired	choice
Name	text
Status	choice

Output fields[3]

Field	Type
Client ID	number
Name	text

Update MemberAction

Input fields[3]

Field	Type
WorkspaceRequired	choice
MemberRequired	choice
Admin	boolean
Hourly rate	number

Output fields[3]

Field	Type
Workspace user ID	number

Update ProjectAction

Input fields[3]

Field	Type
WorkspaceRequired	choice
ProjectRequired	choice
Name	text
Client	choice
Active	boolean
Color	text

Output fields[3]

Field	Type
Project ID	number

Update TaskAction

Input fields[3]

Field	Type
WorkspaceRequired	choice
ProjectRequired	choice
TaskRequired	choice
Name	text
Active	boolean
Estimated seconds	number

Output fields[3]

Field	Type
Task ID	number

Update Time EntryAction

Input fields[3]

Field	Type
WorkspaceRequired	choice
Time entry IDRequired	text
Description	text
Start	date
Duration (seconds)	number
Project	choice
Tags	text

Output fields[3]

Field	Type
Time entry ID	number

Update Timesheet SetupAction

Input fields[3]

Field	Type
WorkspaceRequired	choice
Timesheet setupRequired	choice
Period	choice
Expected hours	number

Output fields[3]

Field	Type
Setup ID	number

Templates

Look for Toggl templates in the WEXTL template library.

Browse templates →

Explore alternative apps

More apps in Productivity category →

References

WEXTL® Toggl Source Code connector implementation.
Our users use cases and automations.
Official API Documentation for Toggl.
WEXTL® visual workflow builder data.

Last updated: Sep 3, 2026 08:07

How we write our apps documentation

How we compile these docs — sources, AI's role, and how we verify.