GoHighLevel V2 icon

GoHighLevel V2

Consume GoHighLevel V2 API
Join our community

Actions26

Overview

The node integrates with the GoHighLevel V2 API, specifically allowing operations on various resources such as contacts, companies, and opportunities. For the Contact - Create operation, it enables users to create a new contact record in their GoHighLevel account by providing essential details like email and phone number, along with optional additional fields.

This node is beneficial for automating CRM workflows where new contacts need to be added programmatically from other systems or triggers. For example, when a lead form is submitted on a website, this node can automatically create a corresponding contact in GoHighLevel, enriching it with custom fields and detailed information.

Properties

Name Meaning
Email The primary email address of the contact to create.
Phone The phone number of the contact.
Additional Fields A collection of optional fields to provide more details about the contact:
- Address Street address of the contact.
- City City where the contact is located.
- Custom Fields User-defined custom fields; each requires selecting a field name or ID and specifying its value.
- Description A textual description of the contact.
- Do Not Disturb Boolean flag indicating if the contact should be marked as "do not disturb".
- Email (Optional) Email of the contact, can override the main Email property if provided here.
- First Name Contact's first name.
- Last Name Contact's last name.
- Name Full name of the contact.
- Phone (Optional) Phone number, can override the main Phone property if provided here.
- Postal Code Postal code of the contact's address.
- State State or region of the contact.
- Timezone Timezone of the contact.
- Website Contact's website URL.

Output

The node outputs an array of JSON objects representing the created contact(s). Each output item contains the full response data returned by the GoHighLevel API for the newly created contact, including all standard and custom fields that were set.

If multiple contacts are created in one execution, the output will be an array of such JSON objects.

The node does not output binary data.

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 required fields such as Email may cause the API to reject the request.
    • Invalid custom field IDs or values can result in errors from the API.
    • Network or authentication failures will prevent successful contact creation.

  • Error Messages:

    • "The resource "contact" is not known!" — This indicates an invalid resource parameter; ensure "contact" is selected.
    • API error messages related to validation or authentication will be passed through; check that the API key or OAuth token is valid and has sufficient permissions.

  • Resolution Tips:

    • Verify all required properties are correctly filled.
    • Use the node’s load options feature to select valid custom field IDs.
    • Ensure the OAuth2 credential is properly configured and authorized.

Links and References

Discussion