Overview
Tenants are hierarchical groups that map to organizations, teams, projects, or environments. They scope notifications with tenant-specific preferences, branding, and metadata.Why tenants matter
One workspace can serve many customers or orgs without duplicating templates. Each tenant gets its own defaults (preferences, branding, provider credentials), so the same flows adapt per context. Useful for B2B SaaS, white-label products, and scoped inboxes or preferences per customer or project.Key Features
Courier’s tenant system provides comprehensive multi-tenant notification management with features including:- Hierarchical Organization - Create parent-child tenant relationships with up to four layers of inheritance
- Scoped Preferences - Set tenant-specific default preferences that users can override on a per-tenant basis
- Custom Branding - Apply different brands and visual styling based on tenant context
- Provider Credentials - Store tenant-specific provider keys (Slack workspace tokens, custom SMTP credentials)
- Flexible Targeting - Send to individual users with tenant context, all tenant members, or nested hierarchies
- Metadata Management - Attach custom properties and profile data that templates can reference
- Send Limits - Configure maximum send limits per tenant for usage control
Core Components
Hierarchical Organization
Create parent-child tenant relationships with up to four layers of inheritance. Child tenants inherit and can override parent metadata, preferences, and branding. Example mapping:Companies → Teams → Projects → Environments
Tenant Sending
Send notifications to entire tenant groups, individual users with tenant context, or leverage hierarchical relationships to target nested organizational structures.Tenant Preferences
Set tenant-specific default preferences that users can override on a per-tenant basis. Support layered preference systems where users have different notification settings per tenant.Tenant Inboxes
Create isolated notification experiences that respect organizational boundaries. Messages sent with tenant context only appear in tenant-configured inboxes.Next Steps
Sending with Tenants
Send notifications with tenant context and targeting
Inbox with Tenants
Configure tenant-specific inboxes and user experiences
User Tenant Preferences
Manage layered preference systems per tenant
Tenant Deep Dive
Comprehensive technical guide to tenant hierarchies and metadata
Tenants API Reference
Complete API documentation for tenant management