Autotask icon

Autotask

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

Actions524

Contract → Get Many

AI-generated

Overview

This node operation retrieves multiple contract records from the Autotask PSA system. It supports fetching all contracts or a limited number based on user input, with options to customize the output fields and include human-readable labels for picklist and reference fields. This operation is useful for scenarios where users need to list or analyze multiple contracts, such as generating reports, syncing contract data with other systems, or performing bulk updates.

Use Case Examples

  1. Fetch all contracts to synchronize with an external CRM system.
  2. Retrieve a limited number of contracts for review or reporting purposes.
  3. Get contracts with specific fields selected to optimize data transfer and processing.

Properties

Name Meaning
Get All Whether to return all contract records or only up to a specified limit.
Max Records Maximum number of contract records to return when not returning all. Range is 1 to 500.
Add Picklist Labels Whether to automatically add human-readable '_label' fields for picklist fields in the contract data.
Add Reference Labels Whether to automatically add human-readable '_label' fields for reference fields in the contract data.
Select Columns Names or IDs. Choose specific contract fields to include in the response. If none are selected, all fields are returned. The ID field is always included.
Flatten User-Defined Fields Whether to bring user-defined fields (UDFs) up to the top level of each contract object instead of nested inside a userDefinedFields array.

Output

JSON

  • id - Unique identifier of the contract record.
  • contractNumber - Contract number or identifier.
  • contractName - Name or title of the contract.
  • startDate - Start date of the contract.
  • endDate - End date of the contract.
  • status - Current status of the contract.
  • billingType - Billing type associated with the contract.
  • userDefinedFields - Array of user-defined fields related to the contract, unless flattened.
  • _label - Human-readable labels for picklist and reference fields if enabled.

Dependencies

  • An API key credential for Autotask PSA REST API

Troubleshooting

  • Ensure the API credentials are correctly configured and have sufficient permissions to access contract data.
  • If the node returns no data, verify that contracts exist in the Autotask system and that filters or limits are set appropriately.
  • Errors related to rate limits may occur; the node attempts to initialize a rate tracker but falls back to local counting if it fails.

Links

Discussion