Field Folders
Organize custom fields into folder hierarchies for better management in complex schemas by grouping related fields by function or domain.
Field Folders bring organizational structure to custom fields. When a contact record or custom object has 30+ fields, finding the right one becomes painful. Folders group related fields by function, business domain, or workflow stage.
What This MCP Tool Does
This tool manages folder hierarchies for organizing custom fields. Create folders to group fields logically, update folder names as your organization evolves, and delete folders that are no longer useful.
Endpoint Reference
Create a folder:
POST /custom-fields/folders
Create a new field folder with a name and optional parent folder.
Update a folder:
PUT /custom-fields/folders/{folderId}
Modify the folder name or hierarchy position.
Delete a folder:
DELETE /custom-fields/folders/{folderId}
Remove a folder. Fields within the folder are not deleted; they become unorganized.
Authentication
Requires a Private Integration Token (PIT) with the appropriate scope enabled.
Key Parameters
When creating or updating folders:
name— display name for the folder- Parent folder reference (for nesting)
- Object association (which object’s fields this folder organizes)
Important Notes
Deleting a folder does not delete the fields inside it. The fields remain as custom fields on the object; they just lose their folder grouping. This is a safe operation from a data perspective.
Folders are an organizational tool for humans, not a technical requirement. The CRM functions the same with or without folders. But for sub-accounts with dozens of custom fields, folders are the difference between a clean, navigable configuration and a chaotic list.
For agencies standardizing sub-account configurations, include folder structures in your provisioning automation. Create fields and organize them into folders as a single setup flow. This ensures every new client account has the same clean organization.
Common folder structures for agencies:
- Contact fields: Personal Info, Business Info, Marketing Data, Service History
- Real estate objects: Property Details, Financial, Listing Status, Agent Info
- Service businesses: Service Preferences, Billing, Equipment, History
Common Questions
Can I nest folders? Check the API for nested folder support. If available, you can create hierarchical structures like “Marketing > Email Preferences > Frequency Settings.”
Do folders appear in the GHL UI? Yes. Folder organization reflects in the CRM interface when viewing and editing records. This improves usability for team members working in the platform.
Can I move a field from one folder to another?
Update the field’s folder assignment through Custom Fields V2 by changing its folderId value.
Related MCP Tools
- Custom Fields V2 — Create fields and assign them to folders
- Object Schema CRUD — Objects whose fields get organized
- Location Custom Fields — V1 field management