Autotask icon

Autotask

Consume Autotask REST API

Actions389

Overview

This node interacts with the Autotask REST API to retrieve detailed information about a specific Contract Service Bundle by its ID. It is useful for users who need to fetch contract service bundle data within their workflows, such as for reporting, auditing, or integration with other systems. For example, a user can input a Contract Service Bundle ID to get all associated details, including user-defined fields and human-readable labels for picklist and reference fields.

Properties

Name Meaning
Service Bundle ID The unique identifier of the contract service bundle to retrieve.
Add Picklist Labels Determines whether to automatically add '_label' fields for picklist fields to provide human-readable values. Labels are not added for empty values.
Add Reference Labels Determines whether to automatically add '_label' fields for reference fields to provide human-readable values. Labels are not added for empty values.
Select Columns Names or IDs. Allows selection of specific 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 Determines whether user-defined fields (UDFs) are 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 contract service bundle.
  • name - The name of the contract service bundle.
  • description - Description of the contract service bundle.
  • userDefinedFields - Array of user-defined fields associated with the contract service bundle, unless flattened.
    _label - Human-readable label for picklist or reference fields, added if enabled. - Other selected fields as specified by the user in 'Select Columns'.

Dependencies

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

Troubleshooting

  • If the Service Bundle 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 before use.
  • If labels are not appearing as expected, check that 'Add Picklist Labels' and 'Add Reference Labels' options are enabled and that the fields have valid values.

Discussion