Haruno Knowledge base

Invitations

How an organization admin invites people, how the invited person sees and answers the invitation on the dashboard, and why no email is sent.

  • DashboardAvailable
Haruno sends no email

An invitation is not emailed. The invited person finds it on the dashboard, after signing in with Google using the same email address that was invited. Tell them so. If they sign in with another address, they see nothing.

Sending an invitation (admin)

On the Organization page, the Invitations card has a form.

The Invitations card with two pending invitations.
The Invitations card. An Email box, a Role box set to Member and a Send invite button. Under them two pending invitations: casey at example dot com as Member, and sam at example dot com as Admin marked Expired, each with a Cancel link.
  1. Type the email address

    The address of the person to invite.

  2. Choose a role

    Member or Admin. See Members and roles.

  3. Press Send invite

    The card says "Invitation sent to" the address, and the invitation joins the list below.

The list shows each pending invitation with the address, a role badge, and Cancel, which asks "Cancel the invitation to …?" first. An invitation that ran out of time is marked Expired. It stays in the list until it is cancelled. By default an invitation expires after 14 days.

The form refuses with these messages:

MessageWhy
Email is required.The box is empty.
That person is already a member of this organizationThey are already in.
There is already a pending invitation for that emailOne waiting invitation for each address.
This organization already has 50 pending invitations. Revoke some before sending more.At most 50 invitations can wait at once.
The Team plan is limited to 5 members. Upgrade the organization to Business to add more.The Team plan is full.

For the very first invitation, see Your personal organization.

Answering an invitation (the invited person)

A person who has been invited sees a pink banner at the top of every dashboard page.

The invitation banner.
A pink banner: You've been invited to join Northgate Partners. Invited as a member by Priya Nair. A tick box: Bring my 2 QuickBooks companies into Northgate Partners. Accept and Decline buttons.
  • It names the organization and says who invited them and in which role.
  • If the person has QuickBooks companies of their own, a tick box asks whether to bring them. Nothing moves unless they tick it. Companies they bring become the organization's and stay with it if they leave.
  • Accept joins the organization. The page follows them in. Decline drops the invitation.
  • The banner shows only to a person who is not yet in an organization. A person belongs to at most one.

If the organization has a plan, joining puts the person on it for as long as they are a member.

When the companies could not be moved

If the person ticked the box and the move failed, the banner says "Your QuickBooks companies stayed yours. They were not moved into Northgate Partners." They can close that note.

When accepting fails

The banner shows the reason in red under the invitation. The common ones:

  • "That invitation has expired" or "That invitation is no longer pending". Ask the admin to send a new one.
  • "Cancel your personal subscription before joining an organization with a seat plan". The person has to end their own paid subscription first.
  • "The Team plan is limited to 5 members. Upgrade the organization to Business to add more."

If the person's email is not verified, the banner has no Accept button. It says "Verify your email — sign in with Google, GitHub, or Microsoft to accept."

The banner names GitHub and Microsoft

Only Google sign-in exists on the dashboard today. The banner's wording is out of date. A customer should sign in with Google, using the invited address.

Last updated · PR #2944 · View this version on GitHub

History (1 version)
  1. Internal knowledge base for staff: site, reader keys, assistant, 197 pages and the PR rule (#2944)
    What changed
    @@ -0,0 +1,78 @@
    +---
    +title: Invitations
    +summary: How an organization admin invites people, how the invited person sees and answers the invitation on the dashboard, and why no email is sent.
    +feature: dashboard-organization
    +covers:
    +  - web/dashboard/components/OrgInvitations.tsx
    +  - web/dashboard/components/InvitationBanner.tsx
    +  - web/dashboard/app/[lang]/organization/page.tsx
    +  - web/dashboard/components/AppShell.tsx
    +  - server-dotnet/src/Haruno.Server/Services/OrgManagementService.cs
    +---
    +
    +<Callout variant="warning" title="Haruno sends no email">
    +An invitation is not emailed. The invited person finds it **on the dashboard**, after signing in with Google using the **same email address** that was invited. Tell them so. If they sign in with another address, they see nothing.
    +</Callout>
    +
    +## Sending an invitation (admin)
    +
    +On the Organization page, the **Invitations** card has a form.
    +
    +<Shot src="/m/67c78f985ea0-dashboard-org-invitations-light.webp" alt="The Invitations card. An Email box, a Role box set to Member and a Send invite button. Under them two pending invitations: casey at example dot com as Member, and sam at example dot com as Admin marked Expired, each with a Cancel link." caption="The Invitations card with two pending invitations." />
    +
    +<Steps>
    +<Step title="Type the email address">
    +The address of the person to invite.
    +</Step>
    +<Step title="Choose a role">
    +**Member** or **Admin**. See [Members and roles](/dashboard/my-organization/members-and-roles/).
    +</Step>
    +<Step title="Press Send invite">
    +The card says "Invitation sent to" the address, and the invitation joins the list below.
    +</Step>
    +</Steps>
    +
    +The list shows each pending invitation with the address, a role badge, and **Cancel**, which asks "Cancel the invitation to …?" first. An invitation that ran out of time is marked **Expired**. It stays in the list until it is cancelled. By default an invitation expires after 14 days.
    +
    +The form refuses with these messages:
    +
    +| Message | Why |
    +|---|---|
    +| Email is required. | The box is empty. |
    +| That person is already a member of this organization | They are already in. |
    +| There is already a pending invitation for that email | One waiting invitation for each address. |
    +| This organization already has 50 pending invitations. Revoke some before sending more. | At most 50 invitations can wait at once. |
    +| The Team plan is limited to 5 members. Upgrade the organization to Business to add more. | The Team plan is full. |
    +
    +For the very first invitation, see [Your personal organization](/dashboard/my-organization/personal-organization/).
    +
    +## Answering an invitation (the invited person)
    +
    +A person who has been invited sees a pink banner at the top of every dashboard page.
    +
    +<Shot src="/m/1196a455a35d-dashboard-org-invite-banner-light.webp" alt="A pink banner: You've been invited to join Northgate Partners. Invited as a member by Priya Nair. A tick box: Bring my 2 QuickBooks companies into Northgate Partners. Accept and Decline buttons." caption="The invitation banner." />
    +
    +- It names the organization and says who invited them and in which role.
    +- If the person has QuickBooks companies of their own, a tick box asks whether to bring them. Nothing moves unless they tick it. Companies they bring become the organization's and stay with it if they leave.
    +- **Accept** joins the organization. The page follows them in. **Decline** drops the invitation.
    +- The banner shows only to a person who is not yet in an organization. A person belongs to at most one.
    +
    +If the organization has a plan, joining puts the person on it for as long as they are a member.
    +
    +<Callout variant="info" title="When the companies could not be moved">
    +If the person ticked the box and the move failed, the banner says "Your QuickBooks companies stayed yours. They were not moved into Northgate Partners." They can close that note.
    +</Callout>
    +
    +### When accepting fails
    +
    +The banner shows the reason in red under the invitation. The common ones:
    +
    +- "That invitation has expired" or "That invitation is no longer pending". Ask the admin to send a new one.
    +- "Cancel your personal subscription before joining an organization with a seat plan". The person has to end their own paid subscription first.
    +- "The Team plan is limited to 5 members. Upgrade the organization to Business to add more."
    +
    +If the person's email is not verified, the banner has no **Accept** button. It says "Verify your email — sign in with Google, GitHub, or Microsoft to accept."
    +
    +<Callout variant="warning" title="The banner names GitHub and Microsoft">
    +Only Google sign-in exists on the dashboard today. The banner's wording is out of date. A customer should sign in with Google, using the invited address.
    +</Callout>