Overview
Tenants in Courier represent hierarchical organizational structures that enable multi-tenant notification management. They allow you to map your user relationships to real-world entities like organizations, teams, projects, or environments, ensuring users receive contextually appropriate notifications with tenant-specific preferences, branding, and metadata. Common use cases include B2B SaaS platforms where users belong to multiple organizations, development teams managing different projects, or enterprise customers with complex departmental structures.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 → EnvironmentsTenant 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