Actions5
- Contact Tags Actions
Overview
This node manages tags associated with contacts in the FullFunnel (GoHighLevel) platform. Specifically, the "Remove Tags" operation allows users to remove one or more tags from a specified contact. This is useful for maintaining accurate and up-to-date contact segmentation by dynamically removing outdated or irrelevant tags.
Common scenarios:
- Removing promotional tags after a campaign ends.
- Cleaning up tags that no longer apply to a contact’s current status.
- Automating tag removal based on user behavior or lifecycle changes.
Practical example:
You have a contact tagged as "lead" and "newsletter". After the contact makes a purchase, you want to remove the "lead" tag automatically to reflect their new status.
Properties
| Name | Meaning |
|---|---|
| Contact ID | The unique identifier of the contact from which tags will be removed. |
| Tags | Comma-separated list of tags to remove from the contact (e.g., "vip, lead-quente, cliente"). |
| Options | Collection of optional settings: |
| Case Sensitive | Whether tag matching should consider case differences (true/false). |
| Create Missing Tags | Whether to create tags if they do not exist yet (true/false). |
| Normalize Tags | Whether to normalize tags by trimming spaces and converting to lowercase (true/false). |
Output
The output JSON object for each input item includes:
success: Boolean indicating if the tag removal was successful.contactId: The ID of the contact processed.tagsRemoved: Array of tags that were removed.- Additional response data returned by the FullFunnel API (if any).
Example output structure:
{
"success": true,
"contactId": "12345",
"tagsRemoved": ["vip", "cliente"],
// ...additional API response fields
}
No binary data is produced by this node.
Dependencies
- Requires an API key credential for authenticating with the FullFunnel (GoHighLevel) REST API.
- The node uses the FullFunnel API endpoint at
https://rest.gohighlevel.com/v2. - Proper configuration of the API credential within n8n is necessary for successful requests.
Troubleshooting
Common issues:
- Invalid or missing Contact ID: Ensure the Contact ID provided exists in FullFunnel.
- Tag names not matching due to case sensitivity or formatting: Adjust the "Case Sensitive" and "Normalize Tags" options accordingly.
- API authentication errors: Verify that the API key credential is correctly configured and has sufficient permissions.
- Network or API downtime: Check connectivity and FullFunnel service status.
Error messages:
- Errors returned from the FullFunnel API are captured and included in the output if "Continue On Fail" is enabled.
- Typical error messages may include "Contact not found" or "Invalid tags".
- To resolve, verify input parameters and API credentials.