Autotask icon

Autotask

Consume Autotask REST API
Join our community

Actions389

Overview

The node retrieves multiple company location records from the Autotask REST API. It is useful for scenarios where you need to fetch a list of company locations, such as for reporting, synchronization with other systems, or bulk data processing. For example, you can use it to get all locations of a company to update an internal database or to display location options in a user interface.

Properties

Name Meaning
Fields Defines which fields of the company location records to retrieve and map in the output. Supports custom mapping and selection of specific fields.
Get All Determines whether to return all matching company location records or limit the number of records returned.
Max Records Specifies the maximum number of company location records to return when 'Get All' is false. The value can range from 1 to 500.
Add Picklist Labels If enabled, adds additional fields with human-readable labels for picklist fields in the output, improving readability.
Add Reference Labels If enabled, adds additional fields with human-readable labels for reference fields in the output.
Select Columns Names or IDs. Allows selection of specific columns (fields) to include in the response. If none are selected, all fields are returned. The ID field is always included.
Flatten User-Defined Fields If enabled, user-defined fields (UDFs) are brought to the top level of each record object instead of being nested inside a userDefinedFields array, simplifying access.

Output

JSON

  • id - Unique identifier of the company location record.
  • name - Name of the company location.
  • address - Address details of the company location.
  • phone - Phone number associated with the location.
  • userDefinedFields - Array of user-defined fields related to the company location, if not flattened.
    _label - Human-readable labels for picklist or reference fields, added if enabled in the input properties.

Dependencies

  • Requires an API key credential for authenticating with the Autotask REST API.

Troubleshooting

  • If the node returns no data, verify that the company has locations and that the API credentials have sufficient permissions.
  • If the node times out or returns an error, check network connectivity and API rate limits.
  • Ensure that the 'Max Records' value is within the allowed range (1-500) when 'Get All' is false.
  • If picklist or reference labels are missing, confirm that the corresponding input properties 'Add Picklist Labels' and 'Add Reference Labels' are enabled.

Discussion