HighLevelPro icon

HighLevelPro

Consume HighLevel API
Join our community

Actions17

Overview

This node integrates with the HighLevel API to update contact information within a specified account location. It allows users to modify various fields of an existing contact, such as name, email, phone number, address, tags, and custom fields. This is useful in scenarios where contact details need to be kept current, for example, updating customer records after receiving new information or correcting data entry errors.

Practical examples include:

  • Automatically updating a contact's phone number and email when they submit a form.
  • Adding or modifying tags on contacts based on their behavior or status changes.
  • Setting custom fields dynamically to track additional attributes relevant to your business processes.

Properties

Name Meaning
Contact ID The unique identifier of the contact to update.
Address The street address of the contact.
City The city where the contact is located.
Custom Fields A collection of custom fields identified by field name or ID, each with a corresponding value to update.
Do Not Disturb Boolean flag indicating if outbound messages are blocked (true means no outbound messages allowed).
Email The contact's email address.
First Name The contact's first name.
Last Name The contact's last name.
Name The full name of the contact; will be overwritten if first and last names are set.
Phone The contact's phone number, which must start with a valid country code prefixed by a plus sign (+).
Postal Code The postal or ZIP code of the contact's address.
State The state or region of the contact's address.
Tags Comma-separated list of tags to assign to the contact. Can also be provided as an array via expression.
Timezone The timezone of the contact, selectable from a list or specified by ID.
Website The contact's website URL.

Output

The node outputs JSON data representing the updated contact object as returned by the HighLevel API. This typically includes all the contact's fields after the update operation, reflecting the new values. The output does not include binary data.

Dependencies

  • Requires an API authentication token configured in n8n credentials to access the HighLevel API.
  • The node uses the base URL https://services.leadconnectorhq.com and expects API version 2021-07-28.
  • The user must have appropriate permissions to update contacts within the specified location in HighLevel.

Troubleshooting

  • Invalid Contact ID: If the provided Contact ID does not exist, the API will likely return an error. Verify the Contact ID is correct and exists in the target location.
  • Authentication Errors: Ensure that the API key or OAuth2 token is valid and has not expired.
  • Invalid Phone Number Format: Phone numbers must start with a plus sign followed by a valid country calling code. Incorrect formats may cause the update to fail.
  • Custom Fields Issues: When specifying custom fields, ensure the field IDs or names are valid and exist in the system. Using invalid custom field identifiers can cause errors.
  • Rate Limits: Frequent updates might hit API rate limits; consider adding delays or batching updates if necessary.

Links and References

Discussion