Invitations

Hisaabo uses email-based invitations to add new members to your organization. This page covers the full invitation lifecycle, from sending to acceptance.

Invitation lifecycle

An Admin or Owner creates an invitation from Settings → Team by entering the invitee’s email and selecting a role.
An invitation email is sent automatically. A copyable link is also displayed in the UI as a fallback.
The invitee clicks the link.

The invitation token is stored in the browser and the invitee is redirected to the login page.

If the Hisaabo app is installed, the invitation deep link opens the app directly. If the app is not installed, the link opens in the device’s browser and prompts the invitee to download the app or continue on the web.

New user: signs up via magic link, completes their profile, and the invitation is auto-accepted. They land directly in the invited organization.
Existing user: clicks the link, the invitation is accepted immediately, and the invited organization is auto-selected in their session.
The invitation expires after 7 days if not accepted.

Accepting invitations

When you click an invitation link in your browser, the token is stored in your session. If you are already signed in, the invitation is accepted immediately and the invited organization appears in your business switcher. If you are not signed in, you are redirected to the login page — the invitation is accepted automatically after you sign in.

When you tap an invitation link on your phone, the Hisaabo app opens directly via deep linking (if installed). The invitation is accepted automatically after you sign in or complete sign-up. The invited organization is then selected as your active business. If the app is not installed, the link opens in your mobile browser where you can accept the invitation on the web.

Pending invitations

After sending an invitation, it appears in the Pending Invitations section at the top of the Team settings page. Each pending invitation shows:

The invitee’s email address
The assigned role
When the invitation was sent

Admins and Owners can revoke any pending invitation at any time. Revoking invalidates the invitation link immediately.

Pending invitations are also accessible via the CLI and MCP server:

CLI: hisaabo tenant invitations
MCP: tenant_pending_invitations tool

What happens to new users

When a user signs up through an invitation link, no auto-created organization is generated for them. They join directly into the invited organization with the role that was set at invitation time.

Available roles at invitation time:

Role	Description
`admin`	Full access to all businesses and settings
`seller_manager`	Manage the sales team and see all invoices
`seller`	Create invoices and record payments
`accountant`	Read-only access to reports and ledgers

After accepting, the invited organization is automatically selected in the user’s session.

Email notifications

Invitation emails are sent automatically using:

Production: Resend (transactional email service)
Development: console log output

Each invitation email contains:

The inviter’s name
The organization name
An Accept button linking to the app
A 7-day expiry notice

If email delivery fails, the copyable link displayed in the Team settings UI is always available as a fallback. Share it with the invitee directly.

Plan limits

The number of team members (including pending invitations) is limited by your plan:

Plan	Max Team Members
Free	3 (including pending invites)
Pro	15
Business	Unlimited
Enterprise	Unlimited

If you reach the limit, you must upgrade your plan or revoke an existing invitation before sending a new one.

CLI and MCP reference

CLI

# List pending invitations
hisaabo tenant invitations
hisaabo tenant invitations --json

# Revoke a pending invitation
hisaabo tenant revoke-invitation <invitationId>

MCP tools

tenant_pending_invitations — list all pending (unaccepted, non-expired) invitations
tenant_revoke_invitation — revoke a pending invitation by UUID

See CLI reference and MCP Server reference for full details.