TwentyDEV icon

TwentyDEV

Consume the Twenty API

Actions252

Overview

The "Find Calendar Channel Duplicates" operation in the Calendar Channels resource is designed to identify duplicate calendar channels based on provided criteria. This node sends a request with specific parameters such as depth of related objects, data filters, and IDs to retrieve potential duplicates of calendar channels.

This operation is useful when managing multiple calendar channels and needing to ensure there are no redundant or overlapping entries. For example, it can help synchronize calendar data by detecting duplicates before merging or cleaning up calendar channels in an application.

Properties

Name Meaning
Depth Determines how much nested related object information to include in the response:
- 0: Only primary calendar channel info.
- 1: Primary object plus directly related objects (no further nesting).
- 2: Primary object, its related objects, and their related objects.
Data JSON array specifying filter criteria or attributes for finding duplicates. Example default includes sync status, sync stage, visibility, and contact auto-creation policy.
Ids JSON array of calendar channel IDs to check for duplicates. Can be used to limit the search to specific calendar channels.

Output

The output is a JSON structure containing the found calendar channel duplicates according to the specified depth and filters. The exact structure depends on the API response but generally includes:

  • Primary calendar channel details.
  • Related objects depending on the depth level.
  • Metadata about synchronization status and visibility if included in the data filter.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for authenticating requests to the underlying calendar service.
  • The node uses an OpenAPI specification bundled internally to build requests.
  • Network access to the calendar service endpoint configured via credentials.

Troubleshooting

  • Invalid JSON in Data or Ids properties: Since these fields expect JSON input, malformed JSON will cause errors. Ensure valid JSON formatting.
  • Authentication errors: Missing or invalid API credentials will prevent successful requests.
  • Depth value out of range: Only 0, 1, or 2 are valid; other values may cause unexpected behavior.
  • Empty or null Ids array: May result in no duplicates found or an error depending on API implementation.
  • API rate limits or network issues: Could cause request failures; verify connectivity and quota.

Links and References

  • No direct external links provided in the source code.
  • Refer to the calendar service's official API documentation for detailed schema and usage of the "find duplicates" endpoint.
  • n8n documentation on creating and using custom nodes for API integrations.

Discussion