Autotask icon

Autotask

Consume Autotask REST API
Join our community

Actions389

Overview

The node interacts with the Autotask REST API to retrieve multiple contract records based on user-defined criteria. It supports fetching either all available contracts or a limited number, with options to select specific fields, include human-readable labels for picklist and reference fields, and flatten user-defined fields for easier access. This node is useful for automating workflows that require bulk contract data retrieval, such as reporting, data synchronization, or integration with other systems.

Properties

Name Meaning
Fields Defines which contract fields to retrieve and map in the output. Supports custom mapping and auto-mapping of fields.
Get All Determines whether to return all matching contract records or limit the number of records returned.
Max Records Specifies the maximum number of contract records to return when 'Get All' is false. Valid range is 1 to 500.
Add Picklist Labels If enabled, adds additional fields with '_label' suffix containing human-readable labels for picklist fields.
Add Reference Labels If enabled, adds additional fields with '_label' suffix containing human-readable labels for reference fields.
Select Columns Names or IDs. Allows selection of specific contract fields to include in the response. If none 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 contract object instead of being nested.

Output

JSON

  • contracts - An array of contract objects retrieved from Autotask, each containing the selected fields and optionally added labels and flattened user-defined fields.

Dependencies

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

Troubleshooting

  • If no contracts are returned, verify that the API credentials are correct and have sufficient permissions.
  • Ensure that the 'Max Records' value is within the allowed range (1-500) when 'Get All' is false.
  • If selected fields do not appear in the output, confirm that the field names or IDs are valid and available for the contract resource.
  • Network or API errors may occur if the Autotask service is unreachable or if rate limits are exceeded; retry after some time or check API usage limits.

Discussion