Skip to content

Team Seats & Roles

Team seats let an account owner invite other people to share the account. Everyone on the team works with the same issuers, badges, and credentials — so a whole organization can collaborate from one badges.ninja account instead of sharing a single login.

Members are managed under Settings → Team (the /members page in the dashboard).

How It Works

  • The account owner invites people by email address.
  • Each invitee receives an email with an accept link.
  • When they click the link and sign in, they join the team and immediately see the account's shared resources.
  • The email address they sign in with must match the address the invitation was sent to.
  • Every member counts as one seat. The number of seats is set by the account's plan (see Seat Limits Per Plan).

Roles

Every member has exactly one role. Roles control what a member can do with the shared account.

RoleManage membersCreate / issueView resources
OwnerYesYesYes
AdminYesYesYes
EditorNoYesYes
ViewerNoNoYes
  • Owner — the account holder. Full control over everything, including billing and the team. There is exactly one owner per account, and the owner seat cannot be removed.
  • Admin — can manage members (invite, change roles, remove) and manage all resources (issuers, badges, credentials).
  • Editor — can create issuers and badges and issue credentials, but cannot manage members.
  • Viewer — read-only access to issuers, badges, and credentials. Cannot create, edit, issue, or manage members.

When you invite someone or change a role, you can only assign Admin, Editor, or Viewer. The Owner role is fixed to the account holder.

Inviting a Member

  1. Open Settings → Team.
  2. Click Invite member.
  3. Enter the person's email address and pick a role (Admin, Editor, or Viewer).
  4. Click Send invite.

The invitee receives an email with an accept link. Until they accept, the invitation shows as Pending in the members list. An invited seat counts against your plan's seat limit as soon as the invite is sent.

Accepting an Invitation

  1. The invitee opens the invitation email and clicks the accept link.
  2. They sign in (or sign up) with the same email address the invite was sent to.
  3. On accepting, they join the team and gain access to the shared account.

If the signed-in email does not match the invited email, the invitation cannot be accepted. Ask the account owner or an admin to re-send the invite to the correct address.

Seat Limits Per Plan

The number of seats — including the owner — depends on the account's plan:

PlanSeats (incl. owner)
Free2
Starter ($9/mo)5
Pro ($29/mo)20

Both accepted members and pending invitations count toward the limit. When you reach the limit, remove a member (or cancel a pending invite) before inviting someone new, or upgrade to a higher plan for more seats.

Managing Roles

Owners and admins can change a member's role at any time:

  1. Open Settings → Team.
  2. Find the member in the list.
  3. Choose a new role — Admin, Editor, or Viewer.

The change takes effect immediately the next time the member's session refreshes.

Removing a Member

  1. Open Settings → Team.
  2. Find the member you want to remove.
  3. Click Remove and confirm.

Once removed, the member immediately loses access to the shared account, and their seat is freed for a new invite. Removing a member does not delete any issuers, badges, or credentials — those belong to the account, not the individual member.

Automating with the API

Everything on the Team page is also available through the REST API. See the Members API reference for the full list of endpoints.

badges.ninja Documentation