Autotask icon

Autotask

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

Actions524

Appointment → Get Many

AI-generated

Overview

This node operation retrieves multiple appointment records from the Autotask PSA system. It supports fetching all appointments or limiting the number of records returned, with options to customize the output fields and format. This operation is useful for scenarios where users need to list or analyze multiple appointments, such as scheduling reviews, reporting, or integration with other systems.

Use Case Examples

  1. Fetch all appointments for a given period to generate a schedule report.
  2. Retrieve a limited number of upcoming appointments for display in a dashboard.
  3. Get appointment details with specific fields for integration with a calendar application.

Properties

Name Meaning
Get All Whether to return all appointment records or only up to a specified limit.
Max Records Maximum number of appointment 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 appointment data.
Add Reference Labels Whether to automatically add human-readable label fields for reference fields in the appointment data.
Select Columns Names or IDs. Choose specific fields to include in the response. If none selected, all fields are returned. The ID field is always included.
Flatten User-Defined Fields Whether to bring user-defined fields up to the top level of each appointment object instead of nested in the userDefinedFields array.
Fields Mapping configuration for appointment fields, allowing definition or auto-mapping of fields to be used in the operation.

Output

JSON

  • id - Unique identifier of the appointment record.
  • subject - Subject or title of the appointment.
  • startDateTime - Start date and time of the appointment.
  • endDateTime - End date and time of the appointment.
  • location - Location where the appointment is scheduled.
  • status - Current status of the appointment.
  • userDefinedFields - Array of user-defined fields associated with the appointment, if not flattened.
  • picklistLabels - Human-readable labels for picklist fields, if enabled.
  • referenceLabels - Human-readable labels for reference fields, if enabled.

Dependencies

  • Autotask PSA REST API
  • API authentication credentials

Troubleshooting

  • Ensure API credentials are correctly configured and have necessary permissions to access appointment data.
  • If no records are returned, verify the query parameters and filters are correctly set.
  • For large data sets, consider enabling 'Get All' carefully to avoid performance issues or API rate limits.
  • If label fields are not appearing as expected, check the 'Add Picklist Labels' and 'Add Reference Labels' settings.

Links

Discussion