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 tags to a lead in a marketing or sales context. It is useful for organizing and categorizing leads by assigning relevant tags, which can help in segmenting leads for targeted campaigns, follow-ups, or analytics.
Typical use cases include:
- Automatically tagging new leads imported from LinkedIn or other sources.
- Adding campaign-specific tags to leads based on user actions or events.
- Managing lead metadata dynamically to improve filtering and reporting.
For example, you might add tags like "Interested", "Webinar Attendee", or "High Priority" to leads after certain interactions.
Properties
| Name | Meaning |
|---|---|
| Tags | List of tags (strings) to add to the lead. Multiple tags can be specified. |
| Create Tag If Not Existing | Boolean option to create tags if they do not already exist. If false, adding a non-existing tag will cause an error. Defaults to true. |
| Additional Fields | Optional additional information about the lead: - Lead LinkedIn ID: The LinkedIn ID of the lead (optional if Profile URL provided). - Profile URL: Full LinkedIn profile URL of the lead (e.g., https://www.linkedin.com/in/john-doe-123456789/). |
Output
The node outputs JSON data representing the result of the tag addition operation. This typically includes confirmation of the tags added and possibly updated lead information reflecting the new tags.
If binary data were involved (not indicated here), it would represent files or media related to the lead, but this node focuses on JSON metadata only.
Dependencies
- Requires an active connection to the HeyReach API via an API key credential.
- The node expects the HeyReach API base URL
https://api.heyreach.io/api/n8n. - Proper API authentication credentials must be configured in n8n for the node to function.
Troubleshooting
- Error when adding tags: If "Create Tag If Not Existing" is set to false and a tag does not exist in HeyReach, the API will return a Bad Request error. To fix this, either enable tag creation or ensure all tags exist beforehand.
- Invalid LinkedIn profile URL or ID: Providing incorrect or malformed LinkedIn identifiers may cause the API to reject the request. Verify the format matches expected LinkedIn URLs or IDs.
- Authentication errors: Ensure the API key credential is valid and has sufficient permissions.
- Empty tags list: Since tags are required, submitting an empty list will likely cause validation errors.
Links and References
- HeyReach API Documentation (general reference for API endpoints and usage)
- LinkedIn Profile URL Format (for correct profile URL formatting)