Overview
This node integrates with the FullFunnel (GoHighLevel) API to manage contacts. Specifically, the Update Contact operation allows users to modify existing contact records by specifying the contact's unique ID and the fields to update.
Common scenarios for this node include:
- Keeping contact information up-to-date in your CRM after changes occur.
- Automating updates to contact details based on external triggers or workflows.
- Adding or modifying tags and custom fields to segment or enrich contact data dynamically.
For example, you might use this node to update a contact’s phone number and add new tags after a customer support interaction.
Properties
| Name | Meaning |
|---|---|
| Contact ID | The unique identifier of the contact to update. |
| Update Fields | Collection of fields to update on the contact. Includes: |
| - Email: New email address. | |
| - Name: Full name of the contact. | |
| - First Name: Contact’s first name. | |
| - Last Name: Contact’s last name. | |
| - Phone: Contact’s phone number. | |
| - Address: Street address line 1. | |
| - City: City name. | |
| - State: State or region. | |
| - Country: Country name. | |
| - Postal Code: Postal or ZIP code. | |
| - Tags: Comma-separated list of tags to assign to the contact. | |
| - Custom Fields: Multiple key-value pairs for custom attributes associated with the contact. |
Output
The node outputs JSON objects representing the updated contact record as returned by the FullFunnel API. The output structure includes all standard and custom fields of the contact after the update.
If the update is successful, the output JSON contains the updated contact data under a contact property or directly as the root object.
No binary data is produced by this node.
Dependencies
- Requires an API authentication token credential for FullFunnel (GoHighLevel).
- The node uses the FullFunnel REST API endpoint at
https://rest.gohighlevel.com/v2. - The user must provide a valid location ID via credentials for scoping contact operations.
Troubleshooting
- Missing Contact ID: The update operation requires a valid contact ID. Omitting it will cause errors.
- Invalid Field Values: Providing improperly formatted emails, phone numbers, or tags may result in API validation errors.
- API Authentication Errors: Ensure the API key credential is correctly configured and has permissions to update contacts.
- Custom Fields Format: Custom fields must be provided as key-value pairs; missing keys or values will be ignored.
- Rate Limits: If updating many contacts rapidly, watch for API rate limiting responses from FullFunnel.
Common error messages:
"Either email or phone is required for upsert operation"— Not applicable here but relevant if switching to upsert.- Network or authentication errors typically indicate misconfigured credentials or connectivity issues.
Links and References
- FullFunnel (GoHighLevel) API Documentation
- n8n Documentation on Creating Custom Nodes