Skip to content

Accepting an Invite

When an admin invites you to a SquadOS organization, you receive an email with a unique link. That link takes you to the acceptance screen, where you either create an account or sign in with one you already have.

The invitation arrives at the email registered by the admin. The message identifies SquadOS and shows:

  • the name of the organization inviting you;
  • the role you will take (Admin, Collaborator, or User);
  • an Accept invite button with a unique link.

If you cannot find the message, check the spam folder. Each link is personal and works only once — do not share it.

The button leads to /accept-invite?token=.... The page validates the invitation, and what you see next depends on whether you already have an account with that email.

The Create account screen appears, with your name and email already filled in:

Create account screen from invite

  1. Set a password with at least 8 characters.
  2. Click Create account and accept.
  3. SquadOS creates the account, accepts the invitation, and logs you in.
  4. You are redirected to the admin panel (if the role is Admin or above) or to the Agent Hub (if it is User or Collaborator).

You don’t need a separate email confirmation step — the invitation already proves the email belongs to you.

If the email already exists:

  1. The page asks you to Sign in.
  2. Log in with email and password as usual.
  3. You go back to the acceptance screen and click Accept invite.
  4. The new organization becomes your active one.

You now have access to two (or more) organizations and switch between them through the selector at the top of the sidebar.

If you were already logged in to a different account, the screen shows an Email mismatch warning and offers a Sign out and sign in with the correct email button:

Warning when the signed-in email differs from the invite

Log out and sign in with the invited email to accept.

The role chosen by the admin defines what shows up after you join (see Users and Roles for the full table):

  • User: accesses the Agent Hub to talk to agents.
  • Collaborator: accesses the Hub and contributes to shared conversations and teams.
  • Admin: accesses the full admin panel (agents, bases, tools, users, conversations, analytics, billing).

Users list in the admin panel

If you expected a different access level, ask the admin to review your role in Users in the admin panel.

Invitations can already come associated with one or more teams in the organization. When you accept, you automatically join those teams and gain access to the agents, bases, and tools they share.

The /accept-invite page shows the Invalid invite state with a message explaining why:

  • Invite expired — invitations are valid for 7 days. Ask the admin to resend through Resend invite in the pending-invitations list under Users.
  • This invite has already been accepted — the link is single-use. If you already joined, sign in directly instead of opening the link again.
  • Invite not found — the link may have been revoked or truncated by a copy/paste error. Request a new one.
  • Plan limit reached — if the organization hit the plan’s user limit, the admin needs to upgrade or free a seat before resending.