EzFlowEzFlow Docs
Marketing

Broadcasts

Sending bulk messages to a list or segment via email.

A Broadcast sends a single email to every eligible contact in a chosen List or Segment. You can send immediately, schedule it for a future time, and optionally trigger list-management actions after it completes.

Creating a broadcast

Go to Marketing → Broadcasts and click New broadcast. Give it a name and optional description, choose an audience (a list or a segment), and compose the content.

Audience

Set Send to to either List or Segment, then pick the target. EzFlow resolves the audience at send time:

  • List — all contacts currently in the list who have an email address and are not unsubscribed.
  • Segment — for a static segment, the current explicit members; for a dynamic segment, contacts that match the criteria at the moment of sending.

In both cases, contacts without an email address and contacts marked as unsubscribed are automatically excluded before sending.

Content and personalization

Compose the email body (HTML) and subject in the broadcast editor. You can personalize content using merge tokens that EzFlow replaces for each recipient:

TokenReplaced with
{{firstName}}Contact's first name
{{lastName}}Contact's last name
{{email}}Contact's email address
{{phone}}Contact's phone number
{{customProperties.fieldName}}Value from the contact's custom properties

Tokens with no matching value are replaced with an empty string.

Test send and preview

Before sending to your full audience you can:

  • Preview — renders the email with sample contact data so you can check layout and tokens.
  • Test send — delivers a real email to a specific address you choose, with sample personalization applied.

Scheduling

A broadcast in Draft status can be scheduled for a future date and time by setting a sendAt value. The broadcast transitions to Scheduled status and is dispatched automatically when that time arrives. You can cancel a scheduled broadcast before it fires.

Status lifecycle

StatusMeaning
DRAFTNot yet sent. Content and audience can be edited.
SCHEDULEDWaiting for the scheduled send time. Can be cancelled.
QUEUEDAccepted for background processing.
SENDINGDelivery in progress.
SENTAll eligible contacts have been processed.
FAILEDA fatal error stopped the send.
CANCELLEDA scheduled broadcast was cancelled before it fired.

Post-send actions

You can configure an optional action that runs on the broadcast's audience after sending completes:

ActionEffect
COPY_TO_LISTAdds every targeted contact to a specified list.
MOVE_TO_LISTAdds every targeted contact to a specified list and removes them from the source list (only applies when the audience is a list).
EMPTY_LISTRemoves every targeted contact from the source list (only applies when the audience is a list).

Post-send action failures are logged but do not affect the broadcast's final status.

Analytics

After a broadcast sends, EzFlow records delivery metrics per broadcast:

  • Total recipients / sent / delivered / opened / clicked / bounced / failed / unsubscribed

View these figures on the broadcast detail page.

  • Contacts — the underlying recipients
  • Lists — static audience groups
  • Segments — static or dynamic audience groups
  • Suppression — how unsubscribes are enforced

On this page