Autotask icon

Autotask

Consume Autotask REST API
Join our community

Actions389

Overview

This node interacts with the Autotask REST API to retrieve multiple Contact records based on user-defined criteria. It is useful for workflows that need to fetch lists of contacts from Autotask, such as syncing contact data, generating reports, or integrating contact information with other systems. For example, a user can retrieve all contacts or limit the number of contacts returned, select specific fields to include, and optionally add human-readable labels for picklist and reference fields.

Properties

Name Meaning
Fields Defines which fields of the Contact resource to retrieve and map in the output. Supports custom mapping and auto-mapping of fields.
Get All Determines whether to return all matching Contact records or limit the results to a maximum number.
Max Records Specifies the maximum number of Contact records to return when 'Get All' is false. The value must be between 1 and 500.
Add Picklist Labels If enabled, adds additional fields with '_label' suffix containing human-readable labels for picklist fields in the Contact data.
Add Reference Labels If enabled, adds additional fields with '_label' suffix containing human-readable labels for reference fields in the Contact data.
Select Columns Names or IDs. Allows selection of specific Contact 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 moved to the top level of each Contact object instead of being nested inside a userDefinedFields array.

Output

JSON

  • id - Unique identifier of the Contact record.
    fields - Values of the selected Contact fields as defined by the user mapping._label - Human-readable labels for picklist or reference fields if 'Add Picklist Labels' or 'Add Reference Labels' is enabled.
  • userDefinedFields - Array of user-defined fields for the Contact, unless flattened to top-level properties.

Dependencies

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

Troubleshooting

  • If no contacts are returned, verify that the resource is set to 'contact' and the operation is 'getMany'.
  • Ensure the API credentials are valid and have sufficient permissions to read Contact data.
  • If the node returns an error about unsupported resource, confirm that the resource parameter is correctly set to 'contact'.
  • When selecting specific fields, ensure the field names or IDs are valid and exist in the Autotask Contact schema.
  • If the maximum records limit is exceeded, reduce the 'Max Records' value or enable 'Get All' to retrieve all records.

Discussion