Joining a community
Two ways in: an invite code from an admin (instant access) or a request that an admin reviews. Here’s what happens on each path, including the email-confirmation step.
On this page
Two ways to join
The /signup page opens with a mode picker. You either have an invite code (you got an email from your board, or someone handed you a code), or you don’t. If you don’t, you submit your address and wait for an admin to review it.
Both paths land you in the same place eventually. The difference is who vets you and how fast.
Invite-code signup
Codes look like short uppercase strings. They’re generated by an admin at /admin/invite-codes against a specific property, and each one carries some metadata that shapes your signup:
Invite type is either owner or resident. Owner codes trigger an ownership transfer: any prior active owner at that property gets their link deactivated when you accept the code. Resident codes require an active owner already linked at the address (residents can’t exist without an owner above them).
Email lock. If the admin set invited_email when generating the code, you can only redeem it with that exact email. The signup form locks the email field once a locked code is validated.
Granted role. Rare, but possible: a code can grant a role above resident at signup. The platform’s bootstrap code (used to create the first system_admin on a brand-new community) is the canonical example.
Request access
No code? Pick “Request access” on the signup page, enter your name, email, password, and the address you live at. The form will try to match your address to a property in the community. If it finds one, that match is shown to the admin during review; if not, the admin sees your raw address text and matches it manually.
Email confirmation
How (and whether) you confirm your email depends on the path. An invite code sent to a specific email already proves that address, so those signups skip confirmation entirely and land you on the dashboard right away. The only invite codes that still need confirmation are generic ones (no email attached, like the bootstrap admin code).
Request access has no pre-proven email, so it confirms with a 6-digit code. After you submit the form, we email the code and the page swaps to a short “enter your code” step in the same tab. Type the code, and you’re through. no new tab, no link to hunt for in your inbox. Generic invite codes still use a one-click confirmation link that lands on /auth/signup-confirm.
Either way, confirmation finalizes the account, links your address (for invite signups), and sends you to the dashboard or the pending screen depending on your status.
Adding another address later
If you already have an approved account at one address and a new code arrives for a second address (say you bought another property in the same community, or you’re moving between units), you don’t need a new account. The signup form has a “link existing account” path: sign in with your current credentials, hand over the code, and the new address gets attached to your profile.
Same vetting rules apply: an owner code still triggers ownership transfer at the new property, and a resident code still requires an active owner there.