Enterprise client invite (Platform administrators)

/companies/add

Creates a new company tenant and emails an enterprise onboarding link to the named primary contact.

:::caution Entitlement

Only isPlatformAdmin (canInviteEnterpriseClients) may access this route—others are redirected away.

:::

---

Steps

1. Ensure you are signed in as Platform administrator.
2. Navigate /companies/add (from Companies area Add affordance when wired, or direct URL).
3. Complete the form:
   • Company name
   • Primary contact name
   • Primary contact email
   • Phone (if collected)
   • Optional Company logo URL
4. Submit — API creates enterprise_client_invites record + sends mail with /enterprise-invites/[share-id] destination.
5. Capture success banner; if email dispatch fails, UI may still return identifiers for manual follow-up (messageId, verificationLink in API JSON—support channel only).

---

After invite

• Ask contact to watch inbox + spam.
• They follow Participant — enterprise invite.
• Track expiry policy operationally (server sets expires_at).

---

Difference from team invite

Flow	Created by	Link
Enterprise client	Platform admin	/enterprise-invites/...
Team member	Primary / Platform	/team-invite/...