Skip to main content

Sign In to the Inbox

The Unified Inbox lives at app.kazenly.com. This is separate from signing in on kazenly.com for the Account Dashboard (see Sign In to kazenly.com in chapter 18).

Most account owners arrive through Open Inbox on the Account Dashboard. Agents usually sign in directly on the inbox with email and password, or set a password from an administrator invite first.

Two Ways In​

WhoTypical pathURL
Account owner / billing adminOpen Inbox on kazenly.com OverviewOpens app.kazenly.com/login?code=… in a new tab
Agent or supervisorEmail + password on the inbox login pageapp.kazenly.com/login
New agent (first time)Invite link → Set Password & Sign Inapp.kazenly.com/set-password?invite=…

Signing in on kazenly.com does not sign you into the Unified Inbox. Use Open Inbox or the inbox login page.

Open Inbox (Account Owners)​

On the Account Dashboard Overview (kazenly.com/dashboard), when your workspace is ready, click Open Inbox (or Opening… while loading).

What happens:

  1. kazenly.com requests a one-time handoff code from the billing API.
  2. Your browser opens a new tab to app.kazenly.com/login?code=… (popup blockers may force navigation in the same tab instead).
  3. The inbox app exchanges the code, loads your tenant configuration, and — when provisioning succeeded — signs you in automatically with an inbox JWT (no password entry on that path).

The handoff URL uses ?code=; ?handoff= is also accepted. The code is single-use and removed from the address bar after exchange.

If Open Inbox is unavailable, common causes include: inbox not set up yet (Set up Inbox first), subscription not entitled, or handoff errors shown on Overview. Fix billing/setup on kazenly.com before retrying.

Direct Sign In (Agents)​

Go to app.kazenly.com/login.

The login screen shows:

  • Title: Kazenly (app short name)
  • Subtitle: Welcome back
  • Fields: Email Address · Password (with show/hide toggle)
  • Button: Sign In (or Signing in… while submitting)

After a successful sign-in, you are redirected to /dashboard inside the Unified Inbox (your role’s default route may differ — for example teacher lands on Questions).

Workspace resolution by email​

Before login, the app may call the billing directory resolve API to attach your email to the correct tenant workspace (when no handoff or invite bootstrap is already loaded). If resolution fails and no workspace is configured, you may see:

We could not connect this email to a workspace. If an account exists for you, use your invite link from email or ask your administrator for help.

If a workspace is found but the API URL is missing:

Workspace found but API URL is not configured yet. Contact your administrator.

Common login errors​

MessageMeaning
Set your password using the invite link from your administrator before signing in.Account exists but password not set yet — use your invite flow
Login failed (generic)Wrong email/password or server error
Directory / workspace errors (above)Email not mapped to a tenant or workspace not ready

There is no Forgot password link on the inbox login page today. If you are locked out, ask your administrator for a new invite or a password reset (admin tooling).

First-Time Agents: Invite and Set Password​

Administrators create agents in Settings → Users and share an invite link. The link includes ?invite= on app.kazenly.com.

Flow:

  1. Open the invite URL. If you land on /login?invite=…, the app redirects to /set-password.
  2. Page subtitle: Set your password. Email may be pre-filled after the invite is validated (Loading invite… while resolving).
  3. Choose New Password and Confirm Password (policy: at least 8 characters with uppercase, lowercase, a number, and a special character from @$!%*?&#).
  4. Click Set Password & Sign In (or Setting password…).
  5. On success you are signed in and sent to /dashboard.

If the invite is invalid, expired, or already used, messages include:

  • This invite link is invalid. Ask your administrator for a new invite.
  • This invite link has expired. Ask your administrator for a new invite.
  • This invite link was already used. Sign in or ask for a new invite.
  • Your password is already set. Sign in with your email and password.

Use Sign in at the bottom of the set-password page if you already completed setup.

While the App Loads​

On first load (especially with ?code=), you may briefly see Loading inbox configuration… while the app applies handoff or restored session bootstrap. Protected routes stay behind AuthGuard until you are authenticated.

After You Are Signed In​

  • Sidebar navigation becomes available (role-dependent — see Inbox vs Dashboard vs Conversations).
  • Default landing is usually sidebar Dashboard at /dashboard.
  • Header shows agent Online / Offline status (separate from login).

To leave the inbox, open the sidebar account menu and choose Logout. That clears your inbox session and returns you to an unauthenticated state.

Session Ended​

If your inbox sign-in ends while you are working, a Session Ended dialog may appear. The body text depends on the reason, for example:

  • Your sign-in has expired. Please sign in again to continue.
  • Your sign-in is missing. Please sign in again to continue.
  • Default: Your session has expired for security reasons. Please sign in again to continue.

Brief network blips while you still have a valid sign-in should not clear your session or force this dialog.

Options:

  • Sign In Now — signs you out and sends you to /login
  • Continue Working — dismisses the dialog temporarily
  • Automatic redirect to login after a 30-second countdown (Redirecting to login in:) if you take no action

If the real-time connection drops on Dashboard, you may also see Connection Lost with Logout-Login again as a recovery link.

kazenly.com vs app.kazenly.com (Quick Reference)​

kazenly.comapp.kazenly.com
Sign-in purposeAccount Dashboard · billingUnified Inbox · agent work
Login button labelSign InSign In
Login lead (account site)Access your Kazenly account and billing.Welcome back (inbox)
Owner entry to inboxOpen Inbox handoffSame handoff lands here
Agent entryNot used for daily inbox work/login or invite

Next Steps​