Skip to main content

Email groups

An email group is a named distribution list, for example alerts-leadership. Notification rules can be wired to a group so every member receives the alert without each person subscribing individually.

Page: Admin -> Email Groups (/admin/email-groups) · Role required: admin

Create a group​

  1. Go to Admin -> Email Groups.
  2. Click Add Group.
  3. Enter a name and an optional description.
  4. Click Create.

Manage members​

  1. Click the members icon on the group row.
  2. In the modal, the left side lists Add Member (people not yet in the group) and the right side lists Current Members.
  3. Click a person to add them.
  4. Click the X next to a member to remove them.

Only people who exist in People can be added.

Edit or delete a group​

  • Edit: pencil icon, change the name or description, then Update.
  • Delete: trash icon, then confirm. Any rule subscriptions pointing at the group stop fanning out.

Send alerts to a group​

Fanning a rule out to a group is done through the notifications API. There is no dedicated admin screen for it today: point a group subscription at a rule with

curl -s -X POST "$API/api/v1/notifications/admin/group-subscriptions" \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H 'content-type: application/json' \
  -d '{
    "rule_key": "ops.pacing_below_forecast",
    "email_group_id": "<group id>",
    "channels": ["email", "slack"]
  }'

When the rule fires, UnitOps creates one delivery per group member in addition to the individually subscribed users. Group fan-out respects the same cooldown as direct subscribers, so a member who is also individually subscribed gets one message, not two.