Actions33
- Lead Actions
- Campaign Actions
- Inbox Actions
- LinkedIn Account Actions
- List Actions
- My Network Actions
- Stat Actions
- Webhook Actions
Overview
This node integrates with the HeyReach API to add multiple leads to a specified lead list. It is useful for automating the process of populating lead lists with detailed contact information, which can then be used for marketing campaigns, outreach, or CRM management.
Typical use cases include:
- Importing new leads collected from various sources into a centralized lead list.
- Enriching existing lead lists by adding additional contacts with detailed profile data.
- Automating lead generation workflows where leads are gathered and immediately added to targeted lists for follow-up.
For example, a marketing team could use this node to automatically add newly acquired leads from a web form into a specific campaign list in HeyReach, including rich details like name, company, position, and custom fields.
Properties
| Name | Meaning |
|---|---|
| List ID | The numeric identifier of the lead list to which the leads will be added. This specifies the target list within HeyReach. |
| Leads | A collection of one or more leads to add. Each lead includes: - First Name - Last Name - Profile URL - Location - Summary - Company Name - Position - About - Email Address - Custom User Fields (multiple key-value pairs) |
The "Leads" property supports multiple entries, allowing batch addition of leads in one execution.
Output
The node outputs JSON data representing the result of the add leads operation. This typically includes confirmation of the leads added, any identifiers assigned by HeyReach, and status messages.
No binary data output is involved.
Dependencies
- Requires an active HeyReach API key credential configured in n8n for authentication.
- Depends on network connectivity to
https://api.heyreach.io/api/n8n. - No other external dependencies are required.
Troubleshooting
- Invalid List ID: If the provided List ID does not exist or is incorrect, the API will return an error. Verify the List ID before running the node.
- Missing Required Fields: Ensure that required lead fields such as email address are correctly populated; otherwise, the API may reject the lead.
- API Authentication Errors: Confirm that the HeyReach API key credential is valid and has necessary permissions.
- Rate Limits or Quotas: Large batches of leads might hit API rate limits; consider splitting input into smaller chunks if errors occur.
- Malformed Custom Fields: Custom user fields must be properly formatted as name-value pairs; invalid formatting can cause request failures.
Links and References
- HeyReach API Documentation (for detailed API usage and field definitions)
- n8n Documentation (for general guidance on using credentials and fixed collections)