Invitations
Accept an invite from a teammate, with or without an existing Bilbis account.
What this means
Bilbis has two invite flows. Which one you use depends on whether you already have a Bilbis account.
| Flow | URL | When |
|---|---|---|
| New-user invite | /invite/<token> | Your admin pre-created the account. The link includes a token that lets you set a password and finish creating your login. |
| Existing-user invite | /org-invite/<token> | You already have a Bilbis account. The link adds you to an organization. |
Both flows start from a link in an email. The link names the organization and the role you'll be granted.
When to use this page
- A teammate sent you a link starting with
/invite/...or/org-invite/.... - You opened the link and you're trying to figure out what to do next.
- The link says it's invalid or expired.
New-user invite (/invite/<token>)
This is the legacy flow. An admin in the organization pre-created your account, and the email has a one-time link that lets you finish setup.
What you see
- Your email address (read-only).
- Your display name (read-only).
- Your role in the organization.
- A password input where you set your password.
Steps
- Click the link in the email.
- Confirm the email and display name shown match what you expect.
- Type a password. At least 12 characters.
- Click submit.
- Bilbis creates your session and lands you on the Workspace picker.
If the page returns "This invite is invalid or has expired", the token has been consumed already or has aged out. Ask the admin to send a new one.
Existing-user invite (/org-invite/<token>)
You already have a Bilbis account. The link adds you to another organization.
What you see
The page reads the invite and branches on your sign-in state:
| State | What the page shows |
|---|---|
| Not signed in | A Sign in prompt with the invited organization and role on top. |
| Signed in as the wrong account | A "wrong account" warning. The signed-in email doesn't match the address the invite was sent to. |
| Signed in as the right account | An Accept button. Clicking it adds you to the organization and redirects to that organization's dashboard. |
Steps
- Click the link in the email.
- If the page asks you to sign in, do so. Use the email the invite was sent to. After sign-in, you return to the same
/org-invite/...page. - If the page shows the "wrong account" warning, sign out and sign in with the right address. Or accept the invite using a different browser session.
- If the page shows the Accept button, click it. You're added to the organization.
What happens after
- You appear on the organization's Members page with the role the invite specified.
- You can see the new organization in the Workspace switcher (top of the sidebar). Switching to it lands you on its dashboard.
- The invite token is consumed and the link won't work again.
Pending invites on the Workspace picker
If you sign in and you have invites you haven't accepted yet, the Workspace picker (/orgs) shows a Pending invites panel above your existing organizations. Each row names the organization, the role, and who invited you. Click Review to open the same /org-invite/... page for that token.
You don't have to accept right away. The invite stays pending until you click Accept or it ages out.
What MFA looks like during an invite
If MFA is enabled on your account, signing in as part of accepting an invite still goes through the MFA challenge. See Multi-factor authentication.
If your role in the new organization would require MFA and you don't have it enrolled yet, the next sign-in routes you to enrollment.
Permissions
| Action | Who can do it |
|---|---|
| Click an invite link | Anyone with the link. |
| Set a password on a new-user invite | The invited user. |
| Accept an existing-user invite | The invited user, signed in to the matching account. |
| Send an invite | Admin or owner - see Members. |
Problems and fixes
| Problem | What to check |
|---|---|
| "This invite is invalid or has expired." | The token was consumed or it's older than the window allows. Ask the admin to send a new invite. |
| The page warns "wrong account". | The email I'm signed in with doesn't match the invite. Sign out and sign in with the right email, or open the link in a different browser. |
| I never received the invite email. | Check spam. Ask the admin to confirm the address they sent to. |
| I clicked accept but I don't see the new organization. | Reload the Workspace picker. If the organization still doesn't appear, ask the admin to check your Members entry. |
I'm an existing user but the link goes to /invite/<token> instead of /org-invite/<token>. | The admin used the legacy flow. The link still works - set a password (or reuse your existing one) and you'll get a separate account. Better to ask the admin to resend with the existing-user flow. |
Related pages
- Sign in and register - sign in before accepting an existing-user invite.
- Multi-factor authentication - MFA challenge if your account has it enabled.
- Members - the admin side of inviting people.
- Switch organizations - move between organizations once you have several.