Actions33
- Lead Actions
- Campaign Actions
- Inbox Actions
- LinkedIn Account Actions
- List Actions
- My Network Actions
- Stat Actions
- Webhook Actions
Overview
The "Add Leads" operation under the "Campaign" resource in this node allows users to add multiple leads to a specified campaign within the HeyReach platform. This is useful for marketing and sales automation workflows where you want to programmatically enrich campaigns with new lead data sourced from various channels or systems.
Typical use cases include:
- Importing leads collected from external forms or CRM systems into a specific campaign.
- Automating lead generation processes by adding leads directly to campaigns for outreach.
- Synchronizing lead data between LinkedIn accounts and marketing campaigns.
For example, a user might have a list of LinkedIn accounts paired with lead details (such as name, profile URL, company, position, email, and custom fields) and wants to bulk add these leads to a campaign identified by its ID.
Properties
| Name | Meaning |
|---|---|
| Campaign ID | The numeric identifier of the campaign to which the leads will be added. This is required to specify the target campaign. |
| Account Lead Pairs | A collection of pairs, each containing: - LinkedIn Account ID: Numeric ID of the LinkedIn account associated with the lead. - Lead Details: Information about the lead including first name, last name, profile URL, location, summary, company name, position, about, email address, and any number of custom user-defined fields (name-value pairs). Multiple such pairs can be added in one execution. |
Output
The node outputs JSON data representing the result of the add leads operation. Typically, this would include confirmation of the leads being successfully added to the campaign, possibly with identifiers or status messages per lead.
If the node supports binary data output, it would generally relate to attachments or files associated with leads, but based on the provided code and properties, this operation focuses on JSON lead data only.
Dependencies
- Requires an active connection to the HeyReach API via an API key credential configured in n8n.
- The base URL for API requests is
https://api.heyreach.io/api/n8n. - Proper permissions on the HeyReach account to add leads to campaigns.
- The user must provide valid campaign IDs and LinkedIn account IDs recognized by HeyReach.
Troubleshooting
- Invalid Campaign ID: If the campaign ID does not exist or the user lacks permission, the API may return an error. Verify the campaign ID and credentials.
- Malformed Lead Data: Missing required lead fields or invalid data types could cause request failures. Ensure all required lead details are correctly formatted.
- API Authentication Errors: If the API key is missing, expired, or incorrect, authentication errors will occur. Check the API key configuration in n8n credentials.
- Rate Limits or Quotas: Adding many leads at once might hit API rate limits. Consider batching large datasets.
- Empty Account Lead Pairs: If no lead pairs are provided, the operation will effectively do nothing or throw an error. Always supply at least one pair.
Links and References
- HeyReach API Documentation (general reference for API endpoints and data formats)
- n8n Documentation (for configuring credentials and using nodes)
This summary is based solely on static analysis of the provided source code and property definitions without runtime execution.