Taifa MailTaifa Mail Docs
Workspaces & Teams

Members & Invites

Invite officers, ICT staff, and developers into an institution workspace, assign roles, and manage access.

An institution workspace can have any number of members. Each member signs in with their own account and sees domains, mailboxes, sends, logs, and settings according to their role.

Roles

Every member holds one of four roles. The dashboard shows the government-facing labels below; the API uses the technical ids in parentheses.

Label (API id)Can do
Authorizing Officer (owner)Everything, including institution settings, members, domains, mailboxes, allocation requests, and the danger zone. Each workspace must always keep at least one Authorizing Officer.
ICT administrator (admin)Manage domains, mailboxes, API keys, SMTP credentials, webhooks, members, and invites. Cannot change or remove an Authorizing Officer.
Communications officer (comms)Compose and send mail, manage broadcasts, audiences, templates, and delivery analytics.
Officer (member)Use mailboxes assigned to them (webmail and IMAP). Cannot manage domains, keys, members, or institution settings.

Inviting someone

  1. Go to Settings → Team.
  2. Click Invite member.
  3. Enter the person's official email address and choose a role.
  4. Click Send invite.

Only Authorizing Officers and ICT administrators can send invites. Inviting someone as Authorizing Officer requires that you are an Authorizing Officer yourself. You cannot invite an email that already belongs to a member of the workspace.

The invitee receives an email with a secure link. The invite expires after 7 days and can be accepted only once. Sending another invite to the same address before it is accepted refreshes the existing invite rather than creating a duplicate.

The invitee does not need a Taifa Mail account beforehand. Opening the invite link walks them through signing in and then joining the institution workspace.

Accepting an invite

When you open an invite link you will see a preview of the institution workspace you are joining. Sign in or create an account and confirm to join. The new workspace then appears in your workspace switcher.

Managing members

From Settings → Team, an Authorizing Officer or ICT administrator can:

  • Change a role: promote an Officer to Communications officer or ICT administrator, or hand over Authorizing Officer status. Only an Authorizing Officer can change another Authorizing Officer's role, and the last remaining Authorizing Officer cannot be demoted.
  • Revoke a pending invite: before it is accepted.
  • Remove a member: they immediately lose access to the institution workspace. Their own account and any other workspaces are unaffected. The last remaining Authorizing Officer cannot be removed.

Any member can remove themselves from a workspace (again, except the last Authorizing Officer). Removing the last Authorizing Officer is always blocked: promote someone else first.

Removing a member does not delete domains, mailboxes, keys, sends, or logs they created. Those belong to the institution workspace and stay with it.

On this page