Autotask icon

Autotask

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

Actions524

Contact Webhook → Get Many

AI-generated

Overview

The node interacts with the Autotask PSA REST API to retrieve multiple contact webhook records. It supports fetching all records or limiting the number of records returned, and allows customization of the output by selecting specific fields, adding human-readable labels for picklist and reference fields, and flattening user-defined fields for easier access. This operation is useful for scenarios where you need to bulk retrieve contact webhook data for integration, reporting, or automation purposes.

Use Case Examples

  1. Retrieve all contact webhook records to synchronize with another system.
  2. Fetch a limited number of contact webhook records for display in a dashboard.
  3. Get contact webhook records with specific fields and labels for detailed analysis.

Properties

Name Meaning
returnAll Whether to return all results or only up to a given limit.
maxRecords Max number of records to return (1-500).
addPicklistLabels Whether to automatically add "_label" fields for picklist fields with human-readable values (no labels will be added for empty values).
addReferenceLabels Whether to automatically add "_label" fields for reference fields with human-readable values (no labels will be added for empty values).
selectColumns 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.
flattenUdfs Whether to bring user-defined fields up to the top level of each object. When enabled, UDFs will be accessible as top-level properties instead of being nested in the userDefinedFields array.
fieldsToMap Mapping of fields to include or transform in the output, supporting auto-mapping and multi-key matching.

Output

JSON

  • id - Unique identifier of the contact webhook record.
  • name - Name of the contact webhook.
  • url - URL endpoint of the webhook.
  • event - Event that triggers the webhook.
  • active - Status indicating if the webhook is active.
  • createdDate - Date when the webhook was created.
  • modifiedDate - Date when the webhook was last modified.
  • _label - Human-readable labels for picklist and reference fields if enabled.
  • userDefinedFields - User-defined fields nested or flattened based on configuration.

Dependencies

  • Autotask PSA REST API
  • API authentication token or API key credential

Troubleshooting

  • Ensure API credentials are correctly configured and have necessary permissions to access contact webhook data.
  • If no records are returned, verify that the contact webhooks exist and the query parameters (like maxRecords) are set appropriately.
  • Errors related to rate limits may occur; ensure the API rate tracker is initialized properly or handle rate limiting in your workflow.
  • If labels for picklist or reference fields are missing, check that the corresponding options (addPicklistLabels, addReferenceLabels) are enabled.

Links

Discussion