Actions16
- Contact Actions
- Contact Tagging Actions
- Data Field Actions
- Opt-In Process Actions
- Tag Actions
Overview
This node is designed to interact with a contact management system, specifically to list contacts that are tagged with a particular tag. It is useful in scenarios where you want to segment or filter contacts based on tags for targeted marketing, communication, or data analysis. For example, you might use this node to retrieve all contacts tagged as "VIP customers" or "Newsletter subscribers" to send them personalized emails or offers.
Properties
| Name | Meaning |
|---|---|
| Tag | Choose a tag from the list of available tags or specify a tag ID using an expression. The node will list all contacts associated with the selected tag. |
Output
The output contains a JSON array of contacts that have been tagged with the specified tag. Each item in the output represents a contact object with its associated data fields (such as name, email, and other contact details). The node does not explicitly mention binary data output, so it is assumed to output only JSON data representing the contacts.
Dependencies
- Requires access to the external contact management service API.
- Needs an API key or authentication token configured in n8n to authorize requests.
- Utilizes a method to dynamically load available tags (
getTags), which implies the node fetches tag options from the external service.
Troubleshooting
- No contacts returned: Ensure the tag ID is correct and that there are contacts associated with the tag.
- Authentication errors: Verify that the API credentials are correctly set up and have sufficient permissions.
- Tag loading issues: If the tag dropdown does not populate, check network connectivity and API availability.
- Invalid tag ID: Using an incorrect or malformed tag ID may cause errors; use the provided tag selector or valid expressions.
Links and References
- n8n Expressions Documentation — for guidance on specifying dynamic values such as tag IDs.
- Refer to the external contact management service's API documentation for details on tags and contacts.