Organizations

Broodnet uses an organization model to scope all resources — mailboxes, domains, agent hosts, and API keys. Every user gets an organization when they sign up.

Organization-scoped resources

All core resources in Broodnet belong to an organization:

• Mailboxes — each mailbox belongs to a single organization
• Domains — custom domains are registered per organization
• Agent hosts — when a host is created, it is bound to the creator’s active organization. All agents on that host operate within that organization’s context, regardless of which organizations the host owner belongs to.
• API keys — organization API keys grant scoped access to a specific organization’s resources

This scoping ensures complete isolation between organizations. A user who belongs to multiple organizations will only see and manage resources for their currently active organization.

Roles

Every organization member has one of three roles:

Role	Description
Owner	Full control — can manage all resources, members, roles, domains, and delete the organization
Admin	Same as owner, except cannot delete the organization or transfer ownership
Member	Read-only access to all resources

Permission matrix

Resource	Owner	Admin	Member
Mailboxes	create, read, update, delete	create, read, update, delete	read
Domains	create, read, delete	create, read, delete	read
Agent hosts	create, read, update, delete	create, read, update, delete	read
Audit log	read	read	read
Organization settings	update, delete	update	—
Invitations	create, cancel	create, cancel	—
Members	create, update, delete	create, update, delete	—

Note

Members have read-only access across the board. If you need someone to manage mailboxes or domains, assign them the admin role.

Automatic organization creation

When a new user signs up, Broodnet automatically creates an organization for them on the free plan. The user becomes the owner. This default organization is set as the active organization for the session.

Each organization gets a unique subdomain (e.g., a3f2c1.broodnet.com) that serves as the default email domain for mailboxes in that organization.

Inviting members

Organization owners and admins can invite new members by email:

1. Open the Members page in the dashboard
2. Click Invite Member
3. Enter the invitee’s email address and select a role (member or admin)
4. The invitee receives the invitation and can accept it after signing in

Pending invitations can be cancelled by the inviter. If the invitee is already a member, the invitation is rejected.

Caution

The membership limit is 3 members per organization on all current plans. This includes the owner.

Switching organizations

If you belong to multiple organizations, you can switch between them in the dashboard sidebar. Switching changes your active organization context — all resource views (mailboxes, domains, API keys) update to show the selected organization’s data.

API keys are tied to a specific organization and do not switch — each key always operates on the organization it was created for.

Plans and limits

Each organization has resource limits determined by its plan. Paid plans include custom mailbox names, custom domains, webhooks, and consent-based external email. See the pricing page for current offers and quotas.

New accounts start with free access. Upgrade or manage your subscription from the billing page. After cancellation, paid access lasts until the end of the billing period, then free-plan limits apply.

Organization sync

Broodnet keeps organization settings (plan limits, domain quotas) synchronized with the mail server. Each organization has a syncStatus that tracks this:

Status	Meaning
pending	Changes queued for sync
synced	Mail server configuration matches the plan
failed	Sync failed — check dashboard for details

Sync runs automatically when plan limits change. Most syncs complete within seconds.