Skip to main content
Senddio developer guide · 7 min read

Transactional vs Broadcast Email

Learn how to classify email by purpose, separate operational messages from marketing broadcasts, and set Senddio’s messageType field correctly.

Classify an email by why the recipient is receiving it. A message needed to complete or understand an account action is usually operational; a message intended to promote, announce, or re-engage belongs in a broadcast or marketing stream. Senddio’s email messageType field labels the request, while your team remains responsible for consent, content, suppression, and legal classification.

This distinction helps teams design safer templates and protect important account mail from unnecessary campaign risk. Start with Senddio’s email channel guide and API reference for current sending requirements.

Classify by purpose

Ask what user or business event caused the send and what the recipient needs from it. A receipt after a purchase, a sign-in alert, or a requested password reset is tied to an individual event. A product newsletter, feature announcement, or promotion is generally a broadcast to an audience.

Some messages contain both operational and promotional material. Treat those as a deliberate policy decision: adding marketing content to a security or transaction email can change user expectations and may affect the message’s legal treatment. Keep the primary purpose obvious, and get qualified advice for jurisdiction-specific questions.

Examples and edge cases

  • Usually transactional: requested password reset, order confirmation, billing receipt, account security alert, or a service status notice for an affected customer.
  • Usually broadcast: newsletter, product launch announcement, promotional offer, event invitation, or a campaign sent to a selected subscriber segment.
  • Needs review: trial-expiration reminders, onboarding sequences, product education, renewal notices with offers, or a status email that also promotes an upgrade.

Keep evidence of the trigger and intended audience in your campaign or event model. A label in code cannot transform the substance of a message. Have product, legal, and lifecycle teams agree on classifications for recurring edge cases.

Set messageType in Senddio

Senddio accepts transactional or broadcast as the email message type. The current API default is transactional when omitted, so set it explicitly in application code to make intent reviewable and avoid relying on a default.

Explicit classification on an email request
curl https://api.senddio.com/v1/send \
  -H "Authorization: Bearer $SENDDIO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "email",
    "messageType": "broadcast",
    "from": "updates@example.com",
    "to": "reader@example.net",
    "subject": "What is new this month",
    "text": "A plain-text version of your campaign message."
  }'

For an event-triggered account message, choose transactional. For an audience campaign, choose broadcast. The API’s accepted response indicates the request was queued; it does not guarantee inbox placement. See the API reference and email channel guide for current payload details and response behavior.

Operate separate email streams

Separate operational and marketing sends in your application’s event model, templates, and reporting. This makes it easier to understand whether a spike came from a product event or a campaign and to apply the right audience rules. Keep suppression and unsubscribe state authoritative, centrally managed, and checked before each broadcast.

Use dedicated sender identities or subdomains when appropriate for your volume and infrastructure, then configure the authentication records Senddio documents for your sending domain. Ramp new traffic gradually, monitor bounces and complaints, and have a plan to pause campaigns if recipient signals deteriorate. Avoid sending to stale, purchased, or unconsented lists.

Protect deliverability and recipient trust

Mailbox providers evaluate authentication, sending patterns, complaints, list quality, and recipient engagement. Align your email authentication with Senddio’s domain setup instructions, keep From identities recognizable, and make subscription preferences easy to find. Follow the current Gmail sender guidelines and Google’s email authentication guidance for applicable Gmail traffic; provider requirements can evolve, so review them before major campaigns.

Transactional mail should remain timely and relevant to the event that triggered it. Marketing mail should go only to eligible recipients and honor opt-outs promptly. Track the two streams separately so campaign complaints do not hide behind strong delivery of account notifications.

Pre-send checklist

  • Document the event or audience rule that triggers the message.
  • Set messageType explicitly for every email send.
  • Keep promotional content out of security and account-critical templates unless reviewed.
  • Check consent, suppression, unsubscribe, and recipient preferences before broadcasts.
  • Authenticate the sending domain and monitor bounces, complaints, and provider feedback.
  • Test the rendered email and plain-text content on representative devices.

For delivery architecture across email and other channels, see multi-channel notifications. Browse the developer guide library for more implementation patterns.

FAQ

Transactional vs Broadcast Email — FAQ

A transactional email is triggered by a user’s action or account relationship and delivers information needed to complete or understand that action, such as a receipt or security alert. Classification depends on purpose and applicable law, not merely the API field.

For email requests, messageType accepts transactional or broadcast. It labels the kind of send for Senddio’s handling. It does not establish legal consent, make a message compliant, or replace your own audience and unsubscribe controls.

Keep security and account-operation messages focused on the requested task. Mixing promotional content can confuse users and change how the message should be treated under applicable rules.

No. Follow the laws and mailbox-provider requirements that apply to your recipients and message. Maintain consent and suppression records and provide a working unsubscribe mechanism for marketing mail.

Put the workflow into practice

Review the API reference for exact request fields and response behavior, then try the workflow on Senddio’s free plan before routing production traffic.

Open the API referenceExplore the free plan