Autotask icon

Autotask

Consume Autotask REST API
Join our community

Actions389

Overview

This node operation retrieves multiple time entry records from the Autotask system using an advanced filtering mechanism. It is useful for users who need to query time entries with complex criteria beyond simple filters, such as date ranges, specific user IDs, or custom conditions. For example, a project manager might use this to extract all time entries logged by a particular team within a certain period for reporting or billing purposes.

Properties

Name Meaning
Get All Determines whether to return all matching time entry records or limit the number of results.
Max Records Specifies the maximum number of time entry records to return when 'Get All' is false. The value must be between 1 and 500.
Advanced Filter A required JSON string containing a 'filter' array that defines the Autotask API query criteria for selecting time entries. This allows complex queries using Autotask's REST API filtering syntax.
Add Picklist Labels If enabled, adds additional fields with '_label' suffix to the output for picklist fields, providing human-readable labels instead of raw values.
Add Reference Labels If enabled, adds additional fields with '_label' suffix to the output for reference fields, providing human-readable labels.
Select Columns Names or IDs. Allows selection of specific fields to include in the response. If no fields are selected, all fields are returned. The ID field is always included.
Flatten User-Defined Fields If enabled, user-defined fields (UDFs) are moved to the top level of each returned object instead of being nested inside a 'userDefinedFields' array.

Output

JSON

  • id - Unique identifier of the time entry record.
  • fieldName - Various fields of the time entry as specified by the selected columns or all fields if none selected.
  • fieldName_label - Human-readable label for picklist or reference fields if label addition is enabled.
  • userDefinedFields - Array of user-defined fields associated with the time entry, unless flattened to top-level properties.

Dependencies

  • Requires an Autotask API key credential for authentication to access the Autotask REST API.

Troubleshooting

  • Invalid JSON in the 'Advanced Filter' property will cause query errors. Ensure the JSON string is well-formed and follows Autotask API filter syntax.
  • Requesting too many records without pagination or limits may cause timeouts or API rate limiting.
  • Selecting fields that do not exist or are misspelled in 'Select Columns' may result in incomplete or error responses.
  • If labels are not appearing as expected, verify that 'Add Picklist Labels' and 'Add Reference Labels' are enabled and that the fields support labels.
  • Ensure the API credentials have sufficient permissions to read time entry data.

Links

Discussion