Autotask icon

Autotask

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

Actions524

Department → Get

AI-generated

Overview

This node operation retrieves detailed information about a specific department in the Autotask PSA system by its unique Department ID. It is useful for scenarios where you need to fetch department data for reporting, integration, or automation purposes within business workflows.

Use Case Examples

  1. Retrieve department details by providing the Department ID to integrate department data into a CRM system.
  2. Fetch department information to display in a dashboard or to use in further processing within an automation workflow.

Properties

Name Meaning
Department ID The unique identifier of the department to retrieve.
Add Picklist Labels Whether to automatically add '_label' fields for picklist fields with human-readable values (no labels will be added for empty values).
Add Reference Labels Whether to automatically add '_label' fields for reference fields with human-readable values (no labels will be added for empty values).
Select Columns Names or IDs. Choose which fields to include in the response. If no fields are selected, all fields will be returned. The ID field is always included regardless of selection.
Flatten User-Defined Fields Whether to bring user-defined fields up to the top level of each object, making UDFs accessible as top-level properties instead of nested in the userDefinedFields array.

Output

JSON

  • id - The unique identifier of the department.
  • name - The name of the department.
  • description - Description or details about the department.
  • userDefinedFields - Array of user-defined fields related to the department, if not flattened.
  • picklistLabels - Human-readable labels for picklist fields, if enabled.
  • referenceLabels - Human-readable labels for reference fields, if enabled.

Dependencies

  • An API key credential for Autotask PSA REST API authentication.

Troubleshooting

  • Ensure the Department ID provided is valid and exists in the Autotask system to avoid 'not found' errors.
  • If labels for picklist or reference fields are not appearing, verify that the respective options are enabled and that the fields have values.
  • If user-defined fields are not accessible as expected, check the 'Flatten User-Defined Fields' option to control their structure.

Links

Discussion