Skip to content
Wholisphere Docs

Accepting an invite

Someone on a Wholisphere org invited you. This page takes you from that email to your first scan. An invitation is one of the ways into the invite-only beta — you don’t need to be on any allowlist; the invite itself grants sign-in.

The email contains a link like:

https://app.wholisphere.ai/invites/<token>

Opening it shows a preview before you sign in: which organization invited you, the role you’ll get, and when the invite expires. If you instead see “Invitation invalid or expired”, the invite was revoked, already used, or past its expiry — ask the sender for a fresh one (admins can re-issue from Settings → Members).

2. Sign in with the invited email

Click Accept invitation. If you’re not signed in yet, you’re bounced to the sign-in page and back afterwards. Sign-in is passwordless: enter your email, we send a magic link (valid 15 minutes), click it, done.

Two things to know:

  • Use the exact email the invite was sent to. Accepting from a different account fails with invite_email_mismatch and tells you which address to use.
  • First sign-in also creates a personal org for you on the Free plan, with you as owner. That’s normal — after accepting, just switch to the team’s org in the org picker.

3. Accept

Back on the invite page, Accept invitation adds you to the org with the invited role and redirects you to the dashboard. (Under the hood: POST /v1/invites/<token>/accept with your session cookie.)

What your role lets you do

Invites carry one of three roles (only an existing owner can later promote someone to owner):

RoleCan do
ViewerRead everything: scans, findings, VPATs, audit log, members.
EditorViewer + run scans (including enqueueing hosted scans) and edit products.
AdminEditor + manage members and invites, create/revoke API keys, billing.
OwnerAdmin + transfer/grant ownership. The last owner can’t be removed or demoted.

If a button in this walkthrough is missing for you, it’s a role issue — ask an admin.

4. Run your first scan

  1. Pick the team org in the org picker (top of the dashboard).
  2. Open New engagement, enter a product name and one or more URLs, choose a monitoring cadence (or “none”), and submit. This creates the product and queues a hosted baseline scan — requires the editor role or higher.
  3. Watch the job on Hosted scans: Queued → Scanning… → Done.
  4. When it finishes, open Scans to browse findings per page and per WCAG criterion.

Where to go next