HeyReach API icon

HeyReach API

Interact with HeyReach API

Overview

This node interacts with the HeyReach API to manage lead lists. Specifically, the "Delete Leads (By LinkedIn ID)" operation under the "List" resource allows users to remove one or more leads from a specified lead list by providing their LinkedIn IDs. This is useful for maintaining and cleaning lead lists by removing outdated or irrelevant contacts.

Practical examples include:

  • Removing leads who have unsubscribed or are no longer relevant.
  • Cleaning up lead lists before launching new campaigns.
  • Managing segmented lead lists dynamically based on LinkedIn activity.

Properties

Name Meaning
List ID The numeric ID of the lead list from which the leads will be deleted.
Lead Member IDs An array of LinkedIn IDs representing the leads to be deleted. These IDs correspond to 'linkedin_id' in API responses.

Output

The node outputs JSON data reflecting the result of the delete operation. Typically, this includes confirmation of successful deletion or details about any errors encountered. The exact structure depends on the HeyReach API response but generally confirms which leads were removed.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the HeyReach API.
  • Needs an API key credential configured in n8n for authentication.
  • The base URL used for requests is https://api.heyreach.io/api/n8n.
  • Proper permissions on the API key to modify lead lists are necessary.

Troubleshooting

  • Common issues:

    • Providing an invalid or non-existent List ID will cause the operation to fail.
    • Supplying LinkedIn IDs that do not exist in the specified list may result in partial success or error messages.
    • Missing or incorrect API credentials will prevent the node from authenticating.
  • Error messages:

    • "Unauthorized" or "Authentication failed": Check that the API key credential is correctly set up and valid.
    • "List not found": Verify the List ID is correct and exists in your HeyReach account.
    • "Invalid LinkedIn IDs": Ensure the LinkedIn IDs provided are accurate and belong to leads in the specified list.

Resolving these typically involves verifying input parameters and ensuring proper API access rights.

Links and References

Discussion