Autotask icon

Autotask

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

Actions524

Configuration Item → Create If Not Exists

AI-generated

Overview

This node operation for the 'Configuration Item' resource with the 'Create If Not Exists' operation allows users to create a configuration item in the Autotask system only if it does not already exist based on specified deduplication fields. It is useful in scenarios where you want to avoid creating duplicate configuration items by checking existing records against certain fields. If a duplicate is found, the node can either update the existing item with specified fields or throw an error, depending on the user's configuration.

Use Case Examples

  1. Automatically add new configuration items from an external system only if they don't already exist in Autotask, using fields like serial number or asset tag for deduplication.
  2. Update existing configuration items with new information if duplicates are found based on specified fields, ensuring data consistency without creating duplicates.

Properties

Name Meaning
Dedup Fields Names or IDs Fields used for duplicate detection. If empty, deduplication is skipped and the item 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 configuration item creation or update. This is required and supports auto-mapping and multi-key matching.

Output

JSON

  • id - The unique identifier of the created or found configuration item.
  • status - The status of the operation, e.g., created, updated, or found duplicate.
  • data - The detailed data of the configuration item after the operation.

Dependencies

  • An API key credential for Autotask API authentication is required.

Troubleshooting

  • If the node throws an error about duplicates, check if 'Error On Duplicate' is enabled and adjust accordingly.
  • Ensure that the deduplication fields are correctly specified and exist in the Autotask configuration item schema.
  • If updates are not applied on duplicates, verify that 'Update Fields' are correctly set and that 'Error On Duplicate' is disabled.

Links

Discussion