Actions33
- Lead Actions
- Campaign Actions
- Inbox Actions
- LinkedIn Account Actions
- List Actions
- My Network Actions
- Stat Actions
- Webhook Actions
Overview
This node interacts with the HeyReach API to retrieve companies from a specified company list. It supports pagination and filtering by keyword, allowing users to fetch subsets of companies efficiently. This is useful in scenarios where you want to process or analyze companies grouped in lists, such as marketing campaigns, lead management, or data enrichment workflows.
For example, you might use this node to:
- Retrieve the first 100 companies from a specific list for targeted outreach.
- Paginate through large lists of companies to process them in batches.
- Filter companies by keywords to focus on relevant subsets.
Properties
| Name | Meaning |
|---|---|
| Offset | Number of records to skip for pagination. Defaults to 0. |
| Limit | Maximum number of records to return. Maximum allowed is 1000. Defaults to 100. |
| List ID | The ID of the company list to retrieve companies from. |
| Additional Fields | Optional fields to refine the query: - Keyword: A string to filter companies by name or other attributes. |
Output
The node outputs JSON data containing the retrieved companies from the specified list. Each item in the output corresponds to a company record with its associated attributes as returned by the HeyReach API.
If binary data were supported, it would typically represent files or media related to companies, but this node focuses on JSON data only.
Dependencies
- Requires an API key credential for authenticating with the HeyReach API.
- The node makes HTTP requests to
https://api.heyreach.io/api/n8n. - No additional external dependencies are required beyond the configured API authentication.
Troubleshooting
- Common issues:
- Invalid or missing API credentials will cause authentication errors.
- Providing an invalid List ID may result in no data or error responses.
- Exceeding the maximum limit (over 1000) will likely cause the request to fail.
- Error messages:
- Authentication failures: Check that the API key credential is correctly configured.
- "List not found" or similar: Verify the List ID is correct and accessible.
- Rate limiting or quota exceeded: Wait and retry later or check API usage limits.
Links and References
- HeyReach API Documentation (general reference for API endpoints and parameters)
- n8n documentation on creating custom nodes