Toggl icon

Toggl

Interact with Toggl Track API
Join our community

Actions8

Overview

This node integrates with the Toggl Track API to manage time tracking data. Specifically, the List Time Entries operation under the Time Entry resource retrieves a list of time entries within an optional date range. This is useful for users who want to analyze or report on tracked work periods over specific intervals.

Common scenarios include:

  • Generating reports of time spent on projects or tasks between two dates.
  • Exporting time entry data for payroll or billing purposes.
  • Monitoring productivity by reviewing historical time logs.

For example, you could use this node to fetch all time entries from the start of the month until today, then process or export that data to another system.

Properties

Name Meaning
Start Date The earliest date/time from which to retrieve time entries (inclusive).
End Date The latest date/time up to which to retrieve time entries (inclusive).
Return All Whether to return all matching time entries without limit (true), or limit the results (false).
Limit Maximum number of time entries to return if Return All is set to false. Minimum value is 1.

Output

The output is an array of JSON objects representing individual time entries retrieved from Toggl Track. Each object contains detailed information about a time entry such as its description, project association, start and end times, duration, tags, workspace ID, and other metadata as provided by the Toggl API.

If multiple items are returned, each is output as a separate item in the node's output array.

No binary data is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Toggl Track API.
  • The node uses internal helper functions to make HTTP requests to Toggl’s REST endpoints.
  • No additional external dependencies beyond the Toggl API and n8n environment are required.

Troubleshooting

  • Invalid date format: Ensure that the Start Date and End Date inputs are valid ISO 8601 date-time strings or properly selected via the date-time picker.
  • No results returned: Check that the date range actually contains time entries; also verify that the authenticated user has access to the workspace and data.
  • API authentication errors: Confirm that the API key credential is correctly configured and has sufficient permissions.
  • Limit ignored when Return All is true: When Return All is enabled, the node ignores the Limit property and fetches all available entries, which may lead to longer execution times or large outputs.
  • Error messages related to network or API issues: These usually indicate connectivity problems or Toggl service outages; retry later or check Toggl status.

Links and References

Discussion