Invite landlords whose properties you manage

Where it lives

1. From the left nav, click Team. URL: /team.
2. Click + Add member in the top right.
3. The Add team member dialog opens.

The invite form

Three required fields, two optional:

• Full name — required. Up to 200 characters. The landlord's real name.
• Email — required. PropFlow validates uniqueness across landlords, tenants, and tradespeople — an email already in use anywhere on PropFlow will be rejected.
• Role — required. As an org-admin you'll see two buttons: Property Manager and Landlord. As a PM you'll only see Landlord. Click Landlord.
• Assign to PM (optional) — only visible when role is Landlord and there's at least one PM in the org. Pick the PM this landlord should report under. Leave blank to have the landlord report directly to you (org-admin).
• Phone — not in the invite form; it's collected later in the landlord's own onboarding wizard (or you can fill it in from the user profile after they accept).

Click Send invite.

What happens behind the scenes

• A landlord row is created with role = "landlord", onboarding_complete = false, and added_by set to either the PM you picked or yourself.
• A Supabase auth user is created with a temporary password.
• Supabase sends a magic-link email via the invite_user_by_email flow.
• The landlord lands in your Team list with a "Pending" badge until they accept.

What the landlord experiences

1. Receives a "You've been invited to PropFlow" email.
2. Clicks the magic link → authenticated session established.
3. Lands at /auth/callback → redirected to /onboarding.
4. Sets a password (≥8 chars).
5. Reviews their profile and clicks Complete setup.
6. Lands at /dashboard.

What the landlord sees once onboarded

• Their own properties — every property you've added to their record, with full visibility into compliance, tenancies, and documents.
• Their own audit log — every action taken on their portfolio, by anyone.
• Limited team visibility — they can see who in your firm is acting on their behalf, but they can't see other landlords' portfolios.
• No property-creation UI — that's done by you (or a PM) on their behalf.

The hierarchy underneath

PropFlow enforces this reporting chain under /team:

org-admin (you)
   ↓
property-manager (optional)
   ↓
landlord

A landlord reports to either a PM (if you assigned one) or to you directly. Reassignment between PMs is via the Team hierarchy view → Reassign PM button — org-admin only.

Common gotchas

• Email already in use. The landlord's email is already on PropFlow elsewhere (another org as a landlord, or as a tenant, or as a tradesperson). Ask them to use a different email, or contact support if you think it's a legitimate dual-role situation.
• Spam folder. Magic-link emails often land in spam for new senders. Tell the landlord to check spam if they don't see the email within a minute.
• Stale invite. Magic-links expire. If the landlord delays for too long, the link won't work — resend from Team.
• PM-only invite. A property manager can only invite landlords (not other PMs). If you need to add a PM, only the org-admin can do that.

Next steps

• Invite property managers (optional) — if you have staff who'll manage subsets of your landlords.
• Add a property on behalf of a landlord — the natural next thing.