Konverte Digital icon

Konverte Digital

Interact with Konverte Digital API

Actions115

Overview

This node operation updates an existing custom filter in the Konverte Digital API. It is useful for scenarios where users need to modify the properties of a saved custom filter, such as changing its name, type, or query criteria. For example, a user might update a filter to refine the conversations or contacts it targets based on new requirements.

Use Case Examples

  1. Updating a custom filter's name and query to better segment conversations.
  2. Changing the type of a custom filter from 'conversation' to 'contact' to adjust its scope.

Properties

Name Meaning
Account Id The numeric ID of the account to which the custom filter belongs.
Custom Filter Id The numeric ID of the custom filter to update.
Name The new name for the custom filter.
Type The type of the custom filter, which can be 'conversation', 'contact', or 'report'.
Query A JSON object representing the query criteria to be saved as the custom filter.
Request Options Additional HTTP request options such as batching, SSL certificate validation, proxy settings, and timeout duration.

Output

JSON

  • id - The unique identifier of the updated custom filter.
  • name - The name of the updated custom filter.
  • type - The type of the updated custom filter.
  • query - The query object saved in the updated custom filter.
  • updated_at - Timestamp indicating when the custom filter was last updated.

Dependencies

  • Requires an API key credential for authentication with the Konverte Digital API.

Troubleshooting

  • Ensure that the 'Account Id' and 'Custom Filter Id' are correct and correspond to existing entities in the system to avoid 'not found' errors.
  • Validate the JSON format of the 'Query' property to prevent parsing errors.
  • If SSL certificate validation errors occur, consider enabling the 'Ignore SSL Issues' option, but be aware of the security implications.
  • Check proxy settings if requests fail due to network restrictions or firewall rules.
  • Adjust the timeout setting if the server response is slow to avoid premature request abortion.

Links

Discussion