Autotask icon

Autotask

Consume Autotask REST API
Join our community

Actions389

Overview

This node operation retrieves multiple contact group contacts from the Autotask system. It is useful for scenarios where you need to fetch a list of contacts associated with contact groups, such as for reporting, synchronization, or bulk processing. For example, you can use it to get all contacts in a specific contact group or to retrieve a limited number of contacts with selected fields for integration with other systems.

Properties

Name Meaning
Fields Defines which fields of the contact group contacts to retrieve and map in the output. Supports custom mapping and selection of specific fields.
Get All Determines whether to return all matching contact group contacts or limit the results to a specified maximum number.
Max Records Specifies the maximum number of contact group contacts to return when 'Get All' is false. The value must be between 1 and 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 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 brought to the top level of each returned object instead of being nested inside a userDefinedFields array.

Output

JSON

  • id - Unique identifier of the contact group contact.
  • contactGroupId - Identifier of the contact group to which the contact belongs.
  • contactId - Identifier of the contact.
  • userDefinedFields - Array of user-defined fields associated with the contact group contact, unless flattened.
    _label - Human-readable label for picklist or reference fields, if enabled.

Dependencies

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

Troubleshooting

  • If no records are returned, verify that the contact group exists and contains contacts.
  • Ensure the API credentials are valid and have sufficient permissions to read contact group contacts.
  • If the node returns an error about unsupported resource or operation, confirm that 'Contact Group Contacts' resource and 'Get Many' operation are selected.
  • When selecting fields, ensure that field names or IDs are valid; invalid fields may cause errors or empty results.
  • If the maximum records limit is set too low, you may not get all desired data; consider enabling 'Get All' to retrieve all records.

Links

Discussion