Autotask icon

Autotask

Interact with Kaseya's Autotask PSA REST API to manage companies, tickets, contracts, and more.

Actions524

Contact Group Contacts → Get Many (Advanced)

AI-generated

Overview

This node operation retrieves multiple contact group contacts from the Autotask PSA system using an advanced filter. It allows users to specify complex query criteria in JSON format to filter the results according to their needs. This operation is useful for scenarios where users need to fetch a customized list of contact group contacts based on specific conditions, such as filtering by group attributes or contact details.

Use Case Examples

  1. Fetch all contact group contacts that belong to a specific group ID.
  2. Retrieve contact group contacts with advanced filtering criteria like status, creation date, or custom fields.

Properties

Name Meaning
Get All Whether to return all results or only up to a given limit.
Max Records Maximum number of records to return when not returning all results (range 1-500).
Advanced Filter A JSON string containing a "filter" array with Autotask API query criteria to filter the contact group contacts.
Add Picklist Labels Whether to automatically add "_label" fields for picklist fields with human-readable values (no labels will be added for empty values).
Add Reference Labels Whether to automatically add "_label" fields for reference fields with human-readable values (no labels will be added for empty values).
Select Columns Names or IDs. Choose which fields to include in the response. If no fields are selected, all fields will be returned. The ID field is always included regardless of selection.
Flatten User-Defined Fields Whether to bring user-defined fields up to the top level of each object, making UDFs accessible as top-level properties instead of nested in the 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.
  • roleId - Identifier of the role assigned to the contact within the group.
  • isPrimary - Boolean indicating if the contact is the primary contact in the group.
  • userDefinedFields - Array of user-defined fields associated with the contact group contact.
  • _label - Additional human-readable labels for picklist and reference fields if enabled.

Dependencies

  • An API key credential for Autotask PSA REST API authentication.

Troubleshooting

  • Ensure the advanced filter JSON is correctly formatted and follows the Autotask API query criteria syntax to avoid query errors.
  • If no results are returned, verify the filter criteria and selected columns to ensure they match existing data.
  • Check API credentials and permissions to confirm access to contact group contacts data.
  • If the node fails, review error messages for details on invalid parameters or network issues and adjust accordingly.

Links

Discussion