BoomerangInstall

Summary

Creates a GoHighLevel custom field for the selected location using the newer v2 endpoint. Choose a name, data type, record model, and whether to show it in forms; optional fields configure its key, folder, form placeholder, description, choices, or file upload settings.

Inputs

• locationId (required) — Sub-account/location to create the field in, loaded from the agency credential.
• nameV2 (required) — Display name for the custom field.
• dataTypeV2 (required) — Field type: checkbox, date, email, file upload, large text, monetary, multiple options, numerical, phone, radio, single option, text, or textbox list.
• createModelV2 (required) — Record type the field attaches to: contact or opportunity. Used as the request's model.
• showInFormsV2 (required) — Whether the field is shown in forms.
• additionalFieldsV2 — Optional settings: field key (auto-derived from model and name if omitted), parent folder ID, placeholder, description, picklist options, accepted file formats, maximum file count, whether radio fields accept a custom option, or custom object key.

Output shape

A single custom field record.

The operation sends locationId in the request body and returns the API's field object, with a legacy customField response shape also accepted.

Examples

Example 1: Create a simple text custom field for contacts

Location: My Sub-account | Name: Customer Tier | Data Type: Text | Model: Contact | Show In Forms: true | Field Key: (auto-derived as contact.customer_tier)

Example 2: Create a dropdown custom field for opportunities

Location: My Sub-account | Name: Deal Source | Data Type: Single Option | Model: Opportunity | Show In Forms: true | Picklist Options: Website, Referral, Partner, Event

Example 3: Create a file upload field with restrictions

Location: My Sub-account | Name: Contract Document | Data Type: File Upload | Model: Contact | Show In Forms: true | Accepted Formats: .pdf,.docx | Max File Limit: 3

Links

• n8n community nodes installation guide