Attio icon

Attio

Interact with Attio API

Records → Assert Record

AI-generated

Overview

This node operation asserts a record in the Attio system. It checks if a record already exists based on a unique matching attribute and either updates or creates the record accordingly. This is useful for ensuring data consistency and avoiding duplicate records in scenarios such as CRM data synchronization or contact management.

Use Case Examples

  1. Use case: Synchronizing contact data from an external system to Attio, ensuring each contact is uniquely identified by an email attribute to prevent duplicates.
  2. Use case: Updating or creating product records in Attio based on a unique SKU attribute during inventory management.

Properties

Name Meaning
Object A UUID or slug to identify the object the record should belong to.
Matching Attribute The ID or slug of the attribute to use to check if a record already exists. The attribute must be unique.
Data The JSON data containing the values to be asserted in the record, including attribute-value pairs.

Output

JSON

  • json - The JSON response from the Attio API representing the asserted record data.

Dependencies

  • Requires an API key credential for Attio API authentication.

Troubleshooting

  • Common issues include invalid or missing API credentials, resulting in authorization errors.
  • Incorrect or missing matching attribute can cause the assertion to fail or create duplicate records.
  • Malformed JSON in the Data property can cause request failures.

Links

  • Attio API Documentation - Official API documentation for Attio, useful for understanding the record assertion endpoint and data structure.

Discussion