HeyReach API icon

HeyReach API

Interact with HeyReach API

Overview

This node interacts with the HeyReach API to retrieve detailed information about a specific lead or company list by its ID. It is useful when you want to fetch and work with data from a particular list stored in HeyReach, such as for marketing campaigns, lead management, or data analysis.

A practical example would be retrieving a list of leads associated with a particular campaign to process or export them in your workflow.

Properties

Name Meaning
List ID The ID number of the lead or company list to retrieve. This is a required numeric value.

Output

The node outputs JSON data representing the details of the requested list. This typically includes metadata and the contents of the list (such as leads or companies it contains). The exact structure depends on the HeyReach API response for a list retrieval.

If the node supports binary data output, it would represent attachments or files related to the list, but this is not indicated in the provided code.

Dependencies

  • Requires an API key credential for authenticating with the HeyReach API.
  • The base URL for API requests is https://api.heyreach.io/api/n8n.
  • The node expects JSON responses and sends JSON requests.

Troubleshooting

  • Common issues:

    • Invalid or missing List ID: Ensure the List ID is provided and corresponds to an existing list.
    • Authentication errors: Verify that the API key credential is correctly configured and has sufficient permissions.
    • Network or API downtime: Check connectivity and HeyReach service status.
  • Error messages:

    • "List not found" or similar indicates the List ID does not exist.
    • Authentication failures suggest invalid or expired credentials.
    • Timeout or connection errors may require retrying or checking network settings.

Links and References

Discussion