Actions5
- Contact Tags Actions
Overview
This node manages tags for contacts in the FullFunnel (GoHighLevel) platform. Specifically, the Replace Tags operation replaces all existing tags of a specified contact with a new set of tags. It first retrieves the current tags of the contact, removes them all, and then adds the new tags provided.
This operation is useful when you want to completely update or reset the tagging of a contact, ensuring that only the specified tags remain assigned. For example, if a contact's status changes and you want to clear old category tags and assign new ones reflecting their current state, this operation automates that process.
Properties
| Name | Meaning |
|---|---|
| Contact ID | The unique identifier of the contact whose tags will be replaced. |
| Tags | Comma-separated list of tags to assign to the contact after removing all existing tags. |
| Options | Collection of optional settings: • Case Sensitive: Whether tag matching should consider case differences. • Create Missing Tags: Whether to create tags that do not yet exist. • Normalize Tags: Whether to normalize tags by trimming spaces and converting to lowercase. |
Output
The output JSON object includes:
success: Boolean indicating if the operation succeeded.contactId: The ID of the contact processed.previousTags: Array of tags that were assigned to the contact before replacement.newTags: Array of tags newly assigned to the contact.- Additional response data from the API call related to adding tags.
This output confirms the tags removed and added, providing traceability of the tag replacement process.
Dependencies
- Requires an API key credential for authenticating with the FullFunnel (GoHighLevel) REST API.
- The node makes HTTP requests to the FullFunnel API endpoint at
https://rest.gohighlevel.com/v2. - Proper configuration of the API credential within n8n is necessary for successful execution.
Troubleshooting
Common Issues:
- Invalid or missing Contact ID can cause failures in retrieving or updating tags.
- Network or authentication errors may occur if the API key is invalid or lacks required permissions.
- If tags are not normalized as expected, verify the "Normalize Tags" option setting.
Error Messages:
- Errors returned from the API will be included in the node output if "Continue On Fail" is enabled.
- Typical error messages might include "Contact not found" or "Unauthorized", indicating issues with the contact ID or API credentials respectively.
Resolutions:
- Double-check the Contact ID format and existence in FullFunnel.
- Ensure the API key credential is valid and has appropriate access rights.
- Adjust options like case sensitivity and normalization to match your tag formatting needs.