HeyReach API icon

HeyReach API

Interact with HeyReach API

Overview

This node integrates with the HeyReach API to manage lead lists. Specifically, the "Delete Leads (By Profile URL)" operation under the "List" resource allows users to delete leads from a specified lead list by providing their LinkedIn profile URLs. This is useful for cleaning up or updating lead lists by removing unwanted or outdated leads based on their LinkedIn profiles.

Practical examples include:

  • Removing leads who have unsubscribed or are no longer relevant.
  • Cleaning a lead list before launching a new campaign.
  • Managing lead data hygiene by deleting duplicates or incorrect entries.

Properties

Name Meaning
List ID The numeric ID of the lead list from which the leads will be deleted.
Lead Profile URLs An array of LinkedIn profile URLs representing the leads to be deleted. Example: ['https://www.linkedin.com/in/username/']

Output

The node outputs JSON data reflecting the result of the deletion operation. Typically, this includes confirmation of which leads were successfully deleted or any errors encountered during the process.

If the node supports binary data output, it would generally relate to any files or attachments returned by the API, but in this case, the operation focuses on JSON responses only.

Dependencies

  • Requires an active connection to the HeyReach API.
  • Needs an API authentication token configured in n8n credentials to authorize requests.
  • The base URL for API requests is https://api.heyreach.io/api/n8n.

Troubleshooting

  • Common issues:

    • Providing an invalid or non-existent List ID may cause the operation to fail.
    • Incorrectly formatted LinkedIn profile URLs can result in leads not being found or deleted.
    • Network or authentication errors if the API key is missing, expired, or invalid.
  • Error messages and resolutions:

    • "List not found" — Verify that the List ID is correct and exists in HeyReach.
    • "Invalid profile URL format" — Ensure all LinkedIn URLs are complete and correctly formatted.
    • "Authentication failed" — Check that the API key credential is properly set up and has necessary permissions.
    • "No leads deleted" — Confirm that the provided profile URLs correspond to leads present in the specified list.

Links and References


This summary is based on static analysis of the node's bundled source code and provided property definitions.

Discussion