> For the complete documentation index, see [llms.txt](https://docs.whiteswan.io/partner-knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.whiteswan.io/partner-knowledge-base/platform-overview/managing-downline-agencies/inviting-new-downlines.md). # Inviting New Downlines To ensure that new agency accounts are associated with your account as their upline, they need to sign up in a special way, which you'll learn more about below. {% hint style="info" %} **Understanding the difference between downline agencies and downline agents.** When you add a new user to your White Swan account, that user will be a part of your company account, and will be covered by the general settings in place for your account. When you invite a new downline agency, they will set up their own company account, which will have its own settings. {% endhint %} On the [Downline Dashboard](/partner-knowledge-base/platform-overview/managing-downline-agencies/downline-dashboard.md), you'll find: 1. A **general Agency Signup Link**. This link can be shared publically and anyone who signs up through this link will have their company account officially linked as a downline agency to your company. 2. An button to **Invite a New Agency**. With this option, you can provide some information on the agency you want to invite, such as company name, company subscription, invitee email, and invitee name. This information will be pre-filled for the person setting up this account to help them save time. The invite link you get from doing this can only be used by the invitee you specified. *** Through our API endpoint [Onboard Agency](/partner-knowledge-base/api-documentation/action-calls/onboard-agency.md), you can access functionality similar to inviting an agency via the Downline Dashboard, but with the ability to provide many more datapoints to pre-fill for them in onboarding. *** While the official downline onboarding methods offered by White Swan offers a good way to onboard downline agencies for most situations, there can still be scenarios where a downline misstakingly signs up through White Swan's general website, and isn't associated as a downline with your company. To handle these situations, you can contact White Swan's team to discuss setting up and providing White Swan access to an API that it can call during normal user onboarding to determine if a user is associated with your company. If a user is associated with your company, this method helps us associate them as a downline even if they don't sign up through the official methods described above. {% hint style="info" %} **Did you know?** If a user visits your downline agency onboarding page while already being associated with another organization on White Swan, they'll have the option to either create a new organization that will be a downline of your organization, or switch the upline for their current organization to your organization. If a user has more than one organization associated with their account, they'll be able to switch the organization they're currently accessing through the top menu. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.whiteswan.io/partner-knowledge-base/platform-overview/managing-downline-agencies/inviting-new-downlines.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.