4leads icon

4leads

Interact with 4leads

Actions33

Overview

This node integrates with the 4leads platform to manage contacts and their tags. Specifically, the "Remove a Tag" operation under the "Contact" resource allows users to remove one or multiple tags from a selected contact. This is useful in scenarios where you want to update contact segmentation dynamically, for example, removing a promotional tag after a campaign ends or cleaning up outdated tags.

Practical examples:

  • Removing a "Newsletter Subscriber" tag when a user unsubscribes.
  • Clearing event-specific tags after the event has passed.
  • Managing customer lifecycle stages by adding/removing tags accordingly.

Properties

Name Meaning
The email of a contact can be used as an alternative ID. A notice informing that the contact's email can be used as an alternative identifier instead of the contact ID.
Contact Select the contact to modify. You can choose from a list of contacts or specify the contact by its ID.
Edit a List of Tags Boolean toggle to decide whether to provide multiple tags at once (true) or a single tag (false) to remove from the contact.
Tag Names or IDs When "Edit a List of Tags" is enabled, select one or more tags from the list or specify their IDs via expressions to remove from the contact.
Tag When "Edit a List of Tags" is disabled, select a single tag from the list or specify its ID to remove from the contact.

Output

The node outputs a JSON array containing the results of the tag removal operation(s). Each item in the output corresponds to the response from the 4leads API for each processed input item. The exact structure depends on the API response but generally includes confirmation of tag removal or updated contact information.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the 4leads API using a configured API authentication credential.
  • The node relies on internal helper methods to fetch lists of contacts and tags for selection.
  • Proper permissions on the 4leads account to modify contact tags are necessary.

Troubleshooting

  • Common issues:

    • Providing an invalid contact ID or tag ID will cause errors; ensure IDs exist and are correct.
    • Attempting to remove tags from a non-existent contact will fail.
    • Network or authentication failures with the 4leads API will prevent successful execution.

  • Error messages and resolutions:

    • "Not a valid tag ID": Occurs if the tag ID does not match the expected numeric format. Use only numeric IDs or select from the provided list.
    • API authentication errors: Verify that the API key credential is correctly set up and has sufficient permissions.
    • Tag not found or cannot be removed: Confirm the tag exists on the contact before attempting removal.

Links and References

Discussion