Autotask icon

Autotask

Consume Autotask REST API

Actions389

Overview

This node operation retrieves a specific Contact Group Contact from the Autotask system using its unique ID. It is useful when you need to fetch detailed information about a particular contact within a contact group, such as for integration, reporting, or automation purposes. For example, you might use this node to get contact details to update a CRM system or to trigger workflows based on contact group membership.

Properties

Name Meaning
Contact Group Contact ID The unique identifier of the contact group contact to retrieve. This is a required field to specify which contact group contact to get.
Add Picklist Labels Determines whether to automatically add human-readable '_label' fields for picklist fields in the response. Labels are only added if the picklist fields have values.
Add Reference Labels Determines whether to automatically add human-readable '_label' fields for reference fields in the response. Labels are only added if the reference fields have values.
Select Columns Names or IDs. Specifies which fields to include in the response. If no fields are selected, all fields are returned. The ID field is always included regardless of selection.
Flatten User-Defined Fields Determines whether user-defined fields (UDFs) should be brought up to the top level of the returned object instead of being nested inside a userDefinedFields array.

Output

JSON

  • id - The unique identifier of the contact group contact.
    fields - Various fields of the contact group contact as specified by the selected columns or all fields if none selected._label - Human-readable labels for picklist or reference fields if 'Add Picklist Labels' or 'Add Reference Labels' options are enabled.
  • userDefinedFields - Array of user-defined fields if 'Flatten User-Defined Fields' is false; otherwise, these fields appear at the top level.

Dependencies

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

Troubleshooting

  • If the Contact Group Contact ID is invalid or not found, the node will throw an error indicating the resource could not be retrieved. Verify the ID is correct.
  • If API authentication fails, ensure the Autotask API credentials are correctly configured and have sufficient permissions.
  • Selecting fields that do not exist may result in incomplete data or errors; verify field names or IDs are valid for the Contact Group Contact resource.
  • Enabling 'Add Picklist Labels' or 'Add Reference Labels' when no corresponding fields have values will not add labels, which is expected behavior.

Discussion