This article is for agencies managing downline agents or sub-agencies.
If you're looking to join an upline agency, see this article.
Your downline, finally in one place.
HealthSherpa Medicare is the only platform built around how your hierarchy actually works. Connections are scoped to just the right level of sharing, so your downline is comfortable connecting, and you get a fuller picture.
Agencies can build multi-level hierarchies by connecting with agents and sub-agencies in two ways:
Captive (LOA) connections: The downline connects exclusively to your agency, giving you access to all of their Contact records.
Independent connections: The downline can connect to multiple upline agencies on a per-carrier basis, sharing limited data from just those carrier's enrollments.
Connect agents and sub-agencies, access realtime data, and get the downline reporting pulse you've always wanted. All with an easy self-serve setup.
Convert to an agency account
To enable agency features, convert your account from an Agent Account to an Agency Account. This adds agency capabilities while retaining all existing agent capabilities (like quoting, enrolling, etc).
How to convert:
Go to your Settings (the ⚙️ icon in the header)
Scroll down to Agency account conversion and click Begin conversion
Add your agency name and phone number
Click Confirm
ℹ️ Note: After you convert, you can only revert with help from our Support team.
After converting, you'll see a new Agency tab in the sidebar, where you can manage your join codes, view connected agents, and see your sub-agency hierarchy.
Your agency join codes
Every agency account gets two join codes – one for captive (LOA) connections and one for independent connections. Share the appropriate code with agents or sub-agencies to connect their accounts to yours.
Captive join codes are for downline agents or agencies who work exclusively under one upline. Connecting with this code gives you full access to their Contact records, and can't be removed without agency approval.
Independent join codes are for downline agents or agencies who may work with multiple uplines across different carriers. These codes are added per-carrier – so downlines can add your join codes for some of their carriers, and not others. And the downline can remove these join codes whenever they like.
To see how to join to your upline, see our Connecting to an upline agency article.
What you get as an agency
Sub-agencies view
If you have one or more sub-agencies connected in your downline, you'll see a Sub-agencies table on the Agency tab. This shows a hierarchical tree of every sub-agency joined under you – including sub-agencies of sub-agencies – so you can see your full downline structure at a glance.
Each row shows the sub-agency's name, join type (Captive or Independent, relative to their immediate parent agency), and join date.
Agents view
The Agents table lists every agent connected across your downline – including agents under your sub-agencies. The Parent Agency column here describes their relationship to the agency they're in.
Your downline Contacts view
You access qualifying Contacts at varied access levels depending on connection.
Qualifying contacts
Once agents or sub-agencies join your agency, you'll gain access to their qualifying Contacts, visible right in your Contacts list, and via your Export.
For captive connections, you qualify for access to every Contact record, with all fields and data visible.
For independent connections, you qualify for Contacts who have a submitted enrollment for a carrier you're connected on – but only enrollments submitted while the connection was active. Enrollments submitted before they connected, or after they disconnected, won't be visible. However, once you've earned visibility into a Contact, you keep it – even if the join code is later removed.
How connection type is determined: The type of connection you have to a downline agent depends on the sub-agency chain between you. If any link in the chain is independent, it's treated as an independent connection from your perspective – even if other links are captive. If every link is captive, it's treated as a captive connection.
In the scenario illustrated above:
Agency A can view:
Humana- and Aetna-enrolled contacts from Agency B and Agent 1
All contacts from Agency C and Agent 2
United-enrolled contacts submitted by the Agency D account itself.
No contacts from Agent 3
Agency B can view and edit all contact data from Agent 1
Agency C can view and edit all contact data from Agent 2
Agency D can view Wellcare-enrolled contacts from Agent 3.
Agency E can view Wellcare-enrolled from Agent 3, and Wellcare- and SCAN-enrolled contacts submitted by the Agency D account itself. If Agency E had independent downline connected on SCAN, Agency E could view their SCAN contacts too.
Access level per Contact
The level of access you get to each qualifying Contact depends on the connection type and your role:
Connection ➡️
Role ⬇️ | For | For Independent agents in your agency | For Captive | For Independent sub-agency |
An agency admin can: | View & edit full data | View limited data | View full data | View limited data |
An agent with Full Book can: | View & edit full data | No access | No access | No access |
An agent can: | No access | No access | No access | No access |
Full data (captive connections) includes everything – details, enrollments, drugs, providers, pharmacies, SOAs, Intakes, Quotes, Notes, and more. This data is live, so you'll always see the most current version.
Limited data (independent connections) includes the Contact's name, state, and zip, the enrolling agent's information, and full enrollment details. This data is a snapshot captured at the time of enrollment submission – it won't change if the agent later edits the contact. Think of it like a receipt.
Full Book access
By default, every Agency Admin has Full Book access to their captive downline's Contacts. Agency admins can also grant Full Book access to direct captive agents.
FAQ
What's the difference between a captive and independent downline?
What's the difference between a captive and independent downline?
We use captive (or LOA) to describe agents or agencies that work exclusively under a single upline. These are typically salaried (W2). Independent describes agents or agencies that may have multiple uplines across different carriers – typically 1099, receiving commission directly. Your usage of these two connections may differ based on the specific relationships you have with your downline. See above for how our system uniquely handles these types.
Can an agency connect to an upline agency?
Can an agency connect to an upline agency?
Yes. Agencies can join an upline agency as either captive or independent, using the Agency tab. See: Joining agency accounts to an upline agency (link).
Can I be both captive and independent to an upline?
Can I be both captive and independent to an upline?
No. You can only have one type of upline connection at a time. If you have a captive upline, you can't also add independent uplines, and vice versa.
What happens if a downline disconnects their join code?
What happens if a downline disconnects their join code?
For independent connections: you'll retain visibility into any enrollments that were already shared with you before the disconnect. But you won't see any new enrollments going forward.
For captive connections: the agency would need to contact support to disconnect a captive downline. Soon, we'll have features that allow the agency to disable or disconnect captive downlines on their own.
What if a downline agent edits a Contact after submitting an enrollment?
What if a downline agent edits a Contact after submitting an enrollment?
For captive connections, you'll see the live, up-to-date data.
For independent connections, you'll see the snapshot from the time of submission. Later edits by the agent won't change what you see. This is by design – it protects the independent agent's book of business while giving you a reliable record of what was enrolled.
What if a downline agent archives a Contact?
What if a downline agent archives a Contact?
Your visibility is not affected. If you had earned access to that Contact through a qualifying enrollment, you'll still see the enrollment snapshot even if the agent archives the contact on their end.
Can I see Contacts from manually added or redirected enrollments in my independent downline?
Can I see Contacts from manually added or redirected enrollments in my independent downline?
For captive connections: Yes.
For independent connections: No. Independent visibility only applies to enrollments submitted through HealthSherpa. Manually added enrollments and carrier redirect enrollments are excluded.
Can a downline agent account convert to an agency account?
Can a downline agent account convert to an agency account?
For independent connections: No – but there's a workaround: you'll need to remove your independent join codes, then convert to an agency account, then add back your independent join codes from your Agency tab.
For captive connections: No – the workaround here: you'll need to disconnect your captive agent account from your agency (by emailing HealthSherpa agent support), then convert to an agency, then add back your captive join code from your Agency tab. It may be easier to create a new account, convert it to an agency account, then add back your captive join code from your Agency tab.
Will I be notified when a downline adds or removes my join code?
Will I be notified when a downline adds or removes my join code?
Yes, when a downline captive agent or agency adds your join code, you'll be notified via email. When a downline independent agent or agency adds or removes your join code, you'll be notified via email.
What's the maximum hierarchy depth?
What's the maximum hierarchy depth?
Currently, hierarchies can be up to 5 sub-agency levels deep – so that'd be a sub-sub-sub-sub-sub-agency from the top of hierarchy. If you need to go past that, contact korey.ashton@healthsherpa.com.
Will I be notified if someone joins or leaves my downline?
Will I be notified if someone joins or leaves my downline?
Yes, if a captive agent or agency joins, you'll get an email notification. If an independent agent or agency adds or removes a carrier connection, you'll get an email notification with details on which carriers they added or removed.
Features up next
Agency reporting tools: Track downline production with reporting and performance insights at the agent level.
Multiple agency admins: Grant admin access to downline agents.
💡 Got feedback?
Share your thoughts on this feature here, or book an Office Hours call.
Questions? Contact support
You can chat with the AI bot anytime (in the bottom-right corner), email medicare-agents@healthsherpa.com, or call (855) 521-4984.







