Autotask icon

Autotask

Consume Autotask REST API
Join our community

Actions389

Overview

The node operation 'Get Many' for the 'Contact Groups' resource retrieves multiple contact group records from the Autotask system. It allows users to fetch a list of contact groups with options to limit the number of records returned or retrieve all available records. This operation is useful for scenarios such as synchronizing contact group data, generating reports, or integrating contact group information into workflows.

Properties

Name Meaning
Fields Defines which fields of the contact groups to retrieve and map in the output, allowing customization of the data returned.
Get All Determines whether to return all contact group records or limit the results to a specified maximum number.
Max Records Specifies the maximum number of contact group records to return when 'Get All' is false. The value ranges from 1 to 500.
Add Picklist Labels Indicates whether to add human-readable label fields for picklist fields in the output, enhancing readability.
Add Reference Labels Indicates whether to add human-readable label fields for reference fields in the output.
Select Columns Names or IDs. Allows selection of specific fields to include in the response by choosing from a list or specifying IDs via expressions. If no fields are selected, all fields are returned. The ID field is always included.
Flatten User-Defined Fields Determines whether user-defined fields (UDFs) are brought to the top level of each contact group object instead of being nested, simplifying access to these fields.

Output

JSON

  • id - Unique identifier of the contact group.
  • name - Name of the contact group.
  • description - Description of the contact group.
  • userDefinedFields - Array of user-defined fields associated with the contact group, unless flattened.
    _label - Human-readable labels for picklist or reference fields, added if enabled.

Dependencies

  • Requires an API key credential for Autotask REST API authentication.

Troubleshooting

  • If the node returns no data, verify that the API credentials are correct and have sufficient permissions to access contact groups.
  • If the maximum records limit is set too low, not all desired records will be returned; consider enabling 'Get All' to retrieve all records.
  • Errors related to field mapping may occur if selected fields do not exist or are misspelled; ensure correct field names or IDs are used.
  • Network or API errors may occur if the Autotask service is unreachable; check network connectivity and API endpoint status.

Discussion