Autotask icon

Autotask

Consume Autotask REST API

Actions389

Overview

This node retrieves detailed information about a specific Contract Service Bundle Unit from the Autotask system using its unique ID. It is useful for workflows that need to fetch and process data related to service bundle units within contracts, such as billing, service management, or contract analysis. For example, it can be used to obtain the details of a service bundle unit to verify its attributes or to integrate contract data into other business systems.

Properties

Name Meaning
Service Bundle Unit ID The unique identifier of the service bundle unit to retrieve. This is a required input to specify which unit's details to fetch.
Add Picklist Labels Determines whether to automatically add human-readable '_label' fields for picklist fields in the response. Labels are not added for empty values.
Add Reference Labels Determines whether to automatically add human-readable '_label' fields for reference fields in the response. Labels are not added for empty 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 each object instead of being nested inside the userDefinedFields array.

Output

JSON

  • id - The unique identifier of the retrieved Contract Service Bundle Unit.
  • fields
    • * - Various properties of the Contract Service Bundle Unit, including standard and user-defined fields as specified by the selected columns.
    • *_label - Human-readable labels for picklist and reference fields, if enabled.
  • userDefinedFields - Array of user-defined fields, unless flattened to top-level properties.

Dependencies

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

Troubleshooting

  • If the Service Bundle Unit 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 specific columns that do not exist may result in incomplete data or errors; verify column names or IDs are valid.
  • Enabling picklist or reference labels when the fields are empty will not add labels; this is expected behavior.

Discussion