Sending With Tenants
Send to tenant members
You can notify a list of tenant members by specifying the tenant_id in the to field. Courier will fan out the message to each user with a tenant membership, look up each user’s profile data, and send the notification.
For example, an inline Inbox notification send:
Will fan out to these list members and send three notifications
Send to a user with a tenant context
You can be explicit about the tenant context when sending a notification. For example, this inbox send:
Will send a notification to user1
with the context information of tenantA
.
This includes default preferences, profile values, the brand of tenantA
and any other data attached to tenantA
that may be referenced by the template.
Note that user preferences and data take precedent over the context loaded from the tenant.
TENANT CONTEXT WITHOUT MEMBERSHIP
A user is not required to be a tenant member to use a tenant context. For example, if user1 does not have a tenant membership to tenantA, you still send a call like the following:
This pattern is useful when your tenants have metadata or credentials for a provider, but you don’t anticipate needing to notify each user in the tenant.
Send to users of children tenants
If you have linked parent and child tenants and want to send to all users that would be part of the children tenants, you can send to all children users by using include_children
key.
In the following hierarchy and using include_children
, Courier would fan out the above request to all five users (User1, User2, User3, User4, User5).