> Map a roster member to a user inside your main location or to a subaccount of their own, and every lead, tag, and activity for that agent routes to the right… *Source: https://aeroidx.com/features/teams/roster-ghl-mapping/ — this is the markdown version of that page, generated at build time.* --- **Browse features** - [AI Coach](https://aeroidx.com/features/ai/ai-coach/) - [AI Lead Alert Suggestions](https://aeroidx.com/features/ai/lead-alert-suggestions/) - [AI Natural Language Search](https://aeroidx.com/features/ai/natural-language-search/) - [AI Property Q&A](https://aeroidx.com/features/ai/property-qa/) - [AI Website Setup](https://aeroidx.com/features/ai/ai-website-setup/) - [AI-Drafted Property Emails](https://aeroidx.com/features/ai/ai-drafted-emails/) - [Advanced Filter Schema](https://aeroidx.com/features/idx/advanced-filter-schema/) - [Custom Search Fields](https://aeroidx.com/features/idx/custom-search-fields/) - [Custom SMTP Email Delivery](https://aeroidx.com/features/idx/custom-smtp-email-delivery/) - [Featured Listings](https://aeroidx.com/features/idx/featured-listings/) - [Listing Details Layout](https://aeroidx.com/features/idx/listing-details-layout/) - [Map Search Widget](https://aeroidx.com/features/idx/map-search-widget/) - [Page Path Configuration](https://aeroidx.com/features/idx/page-path-configuration/) - [Supplemental Listings](https://aeroidx.com/features/idx/supplemental-listings/) - [Agent Alerts & Broker Reports](https://aeroidx.com/features/leads/agent-alerts/) - [Behavioral Tracking](https://aeroidx.com/features/leads/behavioral-tracking/) - [Facebook Dynamic Ads Feed](https://aeroidx.com/features/leads/facebook-ads-feed/) - [Follow Up Boss Integration](https://aeroidx.com/features/leads/follow-up-boss/) - [GoHighLevel Integration](https://aeroidx.com/features/leads/gohighlevel/) - [Lead Routing & Assignment](https://aeroidx.com/features/leads/lead-routing/) - [Leads Dashboard](https://aeroidx.com/features/leads/leads-dashboard/) - [Market Area Subscriptions](https://aeroidx.com/features/leads/market-area-subscriptions/) - [Saved Searches](https://aeroidx.com/features/leads/saved-searches/) - [Send Properties to Leads](https://aeroidx.com/features/leads/send-properties/) - [SureSend Integration](https://aeroidx.com/features/leads/suresend/) - [Component Color Settings](https://aeroidx.com/features/websites/component-color-settings/) - [Custom CSS Themes](https://aeroidx.com/features/websites/custom-css-themes/) - [IDX Button for GoHighLevel](https://aeroidx.com/features/websites/idx-button-for-gohighlevel/) - [One-Click Website](https://aeroidx.com/features/websites/one-click-website/) - [Showing Schedule](https://aeroidx.com/features/websites/showing-schedule/) - [Single Property Websites](https://aeroidx.com/features/websites/single-property-websites/) - [Themed Widget Skins](https://aeroidx.com/features/websites/themed-widget-skins/) - [Visual Widget Builder](https://aeroidx.com/features/websites/visual-widget-builder/) - [Agency Dashboard](https://aeroidx.com/features/teams/agency-dashboard/) - [Embedded Dashboard](https://aeroidx.com/features/teams/embedded-dashboard/) - [Per-Agent Custom Websites](https://aeroidx.com/features/teams/per-agent-websites/) - [Roster Management](https://aeroidx.com/features/teams/roster-management/) - [Roster-to-GHL Sub-Account Mapping](https://aeroidx.com/features/teams/roster-ghl-mapping/) - [Sub-Account Management & Impersonation](https://aeroidx.com/features/teams/sub-accounts-impersonation/) - [API Key Management](https://aeroidx.com/features/developers/api-keys/) - [MCP Server](https://aeroidx.com/features/developers/mcp-server/) - [REST API v1](https://aeroidx.com/features/developers/rest-api/) - [Webhooks](https://aeroidx.com/features/developers/webhooks/) AI 6 - [AI Coach](https://aeroidx.com/features/ai/ai-coach/) - [AI Lead Alert Suggestions](https://aeroidx.com/features/ai/lead-alert-suggestions/) - [AI Natural Language Search](https://aeroidx.com/features/ai/natural-language-search/) - [AI Property Q&A](https://aeroidx.com/features/ai/property-qa/) - [AI Website Setup](https://aeroidx.com/features/ai/ai-website-setup/) - [AI-Drafted Property Emails](https://aeroidx.com/features/ai/ai-drafted-emails/) IDX Search 8 - [Advanced Filter Schema](https://aeroidx.com/features/idx/advanced-filter-schema/) - [Custom Search Fields](https://aeroidx.com/features/idx/custom-search-fields/) - [Custom SMTP Email Delivery](https://aeroidx.com/features/idx/custom-smtp-email-delivery/) - [Featured Listings](https://aeroidx.com/features/idx/featured-listings/) - [Listing Details Layout](https://aeroidx.com/features/idx/listing-details-layout/) - [Map Search Widget](https://aeroidx.com/features/idx/map-search-widget/) - [Page Path Configuration](https://aeroidx.com/features/idx/page-path-configuration/) - [Supplemental Listings](https://aeroidx.com/features/idx/supplemental-listings/) Leads & CRM 11 - [Agent Alerts & Broker Reports](https://aeroidx.com/features/leads/agent-alerts/) - [Behavioral Tracking](https://aeroidx.com/features/leads/behavioral-tracking/) - [Facebook Dynamic Ads Feed](https://aeroidx.com/features/leads/facebook-ads-feed/) - [Follow Up Boss Integration](https://aeroidx.com/features/leads/follow-up-boss/) - [GoHighLevel Integration](https://aeroidx.com/features/leads/gohighlevel/) - [Lead Routing & Assignment](https://aeroidx.com/features/leads/lead-routing/) - [Leads Dashboard](https://aeroidx.com/features/leads/leads-dashboard/) - [Market Area Subscriptions](https://aeroidx.com/features/leads/market-area-subscriptions/) - [Saved Searches](https://aeroidx.com/features/leads/saved-searches/) - [Send Properties to Leads](https://aeroidx.com/features/leads/send-properties/) - [SureSend Integration](https://aeroidx.com/features/leads/suresend/) Websites 8 - [Component Color Settings](https://aeroidx.com/features/websites/component-color-settings/) - [Custom CSS Themes](https://aeroidx.com/features/websites/custom-css-themes/) - [IDX Button for GoHighLevel](https://aeroidx.com/features/websites/idx-button-for-gohighlevel/) - [One-Click Website](https://aeroidx.com/features/websites/one-click-website/) - [Showing Schedule](https://aeroidx.com/features/websites/showing-schedule/) - [Single Property Websites](https://aeroidx.com/features/websites/single-property-websites/) - [Themed Widget Skins](https://aeroidx.com/features/websites/themed-widget-skins/) - [Visual Widget Builder](https://aeroidx.com/features/websites/visual-widget-builder/) Teams 6 - [Agency Dashboard](https://aeroidx.com/features/teams/agency-dashboard/) - [Embedded Dashboard](https://aeroidx.com/features/teams/embedded-dashboard/) - [Per-Agent Custom Websites](https://aeroidx.com/features/teams/per-agent-websites/) - [Roster Management](https://aeroidx.com/features/teams/roster-management/) - [Roster-to-GHL Sub-Account Mapping](https://aeroidx.com/features/teams/roster-ghl-mapping/) - [Sub-Account Management & Impersonation](https://aeroidx.com/features/teams/sub-accounts-impersonation/) Developers & API 4 - [API Key Management](https://aeroidx.com/features/developers/api-keys/) - [MCP Server](https://aeroidx.com/features/developers/mcp-server/) - [REST API v1](https://aeroidx.com/features/developers/rest-api/) - [Webhooks](https://aeroidx.com/features/developers/webhooks/) [Home](https://aeroidx.com/) [Features](https://aeroidx.com/features/) [Teams](https://aeroidx.com/features/all/#teams) Roster-to-GHL Sub-Account Mapping # Roster-to-GHL Sub-Account Mapping Point each agent at the right GoHighLevel account Map a roster member to a user inside your main location or to a subaccount of their own, and every lead, tag, and activity for that agent routes to the right place from then on. [Schedule Demo](https://aeroidx.com/schedule/) [All features](https://aeroidx.com/features/all/) ## What it does Roster-to-GHL Sub-Account Mapping bridges the AeroIDX agent roster with GoHighLevel (GHL) CRM identities. A brokerage can map each roster member either to a GHL user within the main location (user-mode) or to a fully independent GHL subaccount (subaccount-mode) via OAuth. Once mapped, all lead activity, tags, and AeroIDX MCP tool calls for that agent are routed to the correct GHL context. ## Key capabilities - Two mapping modes: one shared GoHighLevel location with users, or a dedicated subaccount per agent - Secure OAuth connection per subaccount with automatic token refresh - Live GoHighLevel user list pulled directly from your account at mapping time - One-to-one mapping enforcement, so a GoHighLevel user can only own one roster spot - Switch mapping mode at any time without losing existing connections - Clean disconnect that fully clears the subaccount credentials - Post-connection guide that walks you through installing the GoHighLevel snapshot ## Good to know - Subaccount OAuth token refresh must be handled manually or via a scheduled job; the controller refreshes on request but there is no proactive background refresh - GHL user-mode mapping requires the brokerage to have a GHL location-level OAuth connection first - Subaccount connection clears any existing `ghl_user_id` mapping for that roster member (the two modes are mutually exclusive per agent) ## Why teams choose this 1. Brokerages running GHL get per-agent lead routing without any manual tagging or reassignment 2. Subaccount mode gives each agent a fully isolated GHL environment, so contacts, pipelines, and automations are never mixed 3. The OAuth flow means no API key copy-paste; agents connect with a click from within AeroIDX 4. Mapping mode can be switched at any time, so teams can start with user-mode and graduate to subaccounts 5. Paired with MCP tools, mapped agents get AI coaching and CRM actions that target their specific GHL context ### Built for Primary Brokerage owner running GoHighLevel for CRM Secondary Agency owner configuring GHL for multiple client brokerages ## Related features [ Roster Management GHL mapping fields live on roster member records ](https://aeroidx.com/features/teams/roster-management/)[ Per-Agent Custom Websites GHL Custom Values sync uses the subaccount connection ](https://aeroidx.com/features/teams/per-agent-websites/)[ Agency Dashboard Agencies configure GHL integrations for each client brokerage ](https://aeroidx.com/features/teams/agency-dashboard/)