Actions26
Overview
This node integrates with the GoHighLevel V2 API to manage contacts, companies, opportunities, and custom fields. Specifically for the Contact resource with the Update or Create operation, it allows users to either update an existing contact or create a new one if it does not exist. This is useful in scenarios where you want to ensure a contact record is present and up-to-date without manually checking its existence first.
Practical examples include:
- Synchronizing contact information from a CRM or form submission into GoHighLevel.
- Automatically updating contact details when new data arrives, or creating a new contact if none exists.
- Managing marketing lists by ensuring contacts are current and complete.
Properties
| Name | Meaning |
|---|---|
| The email address of the contact. Used as a primary identifier for update or creation. | |
| Phone | The phone number of the contact. Can be used to identify or update the contact. |
| Additional Fields | A collection of optional fields to provide more detailed contact information: |
| - Address | Street address of the contact. |
| - City | City of the contact. |
| - Custom Fields | Custom fields specific to the contact, allowing flexible data storage. Each custom field requires a name or ID and a corresponding value. |
| - Description | A textual description of the contact. |
| - Do Not Disturb | Boolean flag indicating whether the contact should be marked as "do not disturb". |
| Email of the contact (can be specified here as well as the main Email property). | |
| - First Name | Contact's first name. |
| - Last Name | Contact's last name. |
| - Name | Full name of the contact. |
| - Phone | Phone number of the contact (can be specified here as well as the main Phone property). |
| - Postal Code | Postal code of the contact. |
| - State | State or region of the contact. |
| - Timezone | Timezone of the contact. |
| - Website | Website URL associated with the contact. |
Output
The node outputs JSON objects representing the updated or created contact records as returned by the GoHighLevel API. Each output item contains the full contact data including all standard and custom fields that were set or retrieved.
If multiple contacts are processed, the output will be an array of such JSON objects.
The node does not explicitly handle binary data output.
Dependencies
- Requires an active connection to the GoHighLevel V2 API via OAuth2 authentication.
- The user must configure appropriate credentials in n8n to authenticate API requests.
- The node relies on internal utility methods and resource handlers bundled within the node’s source code to perform API calls.
Troubleshooting
Common issues:
- Missing or invalid API credentials will cause authentication failures.
- Providing incomplete or invalid email/phone values may result in errors or unexpected behavior since these are key identifiers.
- Custom fields must exist in GoHighLevel; otherwise, setting them may fail.
Error messages:
"The resource \"contact\" is not known!"— indicates an unsupported resource was selected; verify the resource parameter.- API errors related to validation or permissions will be passed through; check the error message for details.
Resolutions:
- Ensure API credentials are correctly configured and have sufficient permissions.
- Validate input data before running the node.
- Use the node’s "Continue On Fail" option to handle individual item errors gracefully.