Autotask icon

Autotask

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

Actions524

Contract Service → Create If Not Exists

AI-generated

Overview

This node operation for the 'Contract Service' resource with the 'Create If Not Exists' operation is designed to create a contract service record in the Autotask PSA system only if a duplicate does not already exist. It helps prevent duplicate entries by allowing users to specify fields for duplicate detection and update fields if differences are found. This operation is useful in scenarios where contract services need to be managed efficiently without creating redundant records, such as in automated contract management workflows or integration scenarios where contract services are synchronized from other systems.

Use Case Examples

  1. Automatically create a new contract service only if it does not already exist based on specified deduplication fields.
  2. Update existing contract service details if differences are found in specified update fields during the creation attempt.
  3. Throw an error if a duplicate contract service is found, based on user preference.

Properties

Name Meaning
Dedup Fields Names or IDs Fields used for duplicate detection. If empty, deduplication is skipped and a new record is always created.
Update Fields Names or IDs Fields to compare against the duplicate. If values differ, the duplicate will be updated. This is ignored when 'Error on Duplicate' is enabled.
Error On Duplicate Whether to throw an error when a duplicate is found instead of returning it.
Fields Fields to map for the contract service record creation or update, supporting auto-mapping and multi-key matching.

Output

JSON

  • id - The unique identifier of the created or found contract service record.
  • status - The status of the operation, e.g., created, found, or updated.
  • data - The detailed data of the contract service record after the operation.

Dependencies

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

Troubleshooting

  • If the node throws an error about duplicate detection, check the 'Error On Duplicate' setting and the deduplication fields configuration.
  • Ensure that the API credentials are correctly set and have sufficient permissions to create or update contract services.
  • If updates are not applied as expected, verify that the 'Update Fields' are correctly specified and that the values differ from the existing record.

Links

Discussion