Delivery rules

Delivery rules decide, per recipient, whether a message is delivered, blocked or redirected before it reaches a provider. They are how you keep test traffic away from real customers.

Creating a delivery rule.

The rules list

Open Automations under Messaging. Each rule shows its channel, condition, outcome and whether it is active, with a count of active rules. Rules are evaluated first-match-wins within their environment.

The delivery rules list showing channel, condition and outcome per rule

1. Create a rule

Click Create Rule. Name it, pick the channel it applies to, and choose the environment it belongs to. Optionally add tags for filtering (tags have no delivery effect).

The rule editor: name, channel, environment, condition and outcome

2. Condition and outcome

The Condition is a case-insensitive substring matched against the recipient address or number: @acme.com, tempmail.com, +1555. Then pick an outcome:

The three outcome cards: Deliver, Block, Redirect
  • Deliver: force the message through.
  • Block: drop it silently.
  • Redirect: send it to a different address or number instead (you supply the destination).

Save with Create Rule. Toggle a rule active or inactive without deleting it from the list or the editor sidebar.

Rules run before the channel default. Messy checks every active rule for the recipient; the first match wins. If none match, the channel default permission on the Integrations page decides. See Connect a provider.

Customization options

FieldTypeDescription
ChannelruleEmail, SMS, WhatsApp or Push. The rule only applies to that channel.
EnvironmentruleScopes the rule to one environment. Rules are evaluated within their environment only.
ConditionruleCase-insensitive substring matched against the recipient address or number.
OutcomeruleDeliver (force through), Block (drop), or Redirect (reroute elsewhere).
Redirect destinationruleWhere a redirected message goes. Required when the outcome is Redirect.
TagsruleFree-form labels for filtering the list. No delivery effect.
ActiveruleActive rules are evaluated; inactive ones are stored but skipped.