Skip to main content
Campaigns are for one-time or scheduled sends to a defined audience.

Campaign Lifecycle

Campaign statuses:
  • draft
  • scheduled
  • processing
  • sent
  • failed
  • cancelled

Create Campaign Checklist

  1. Select a campaign template.
  2. Choose send mode: immediate or scheduled.
  3. Choose audience mode: contacts, tags, filters, or all subscribed.
  4. Validate recipient preview and eligibility.

Audience Modes

  • contacts: explicit contact IDs
  • tags: selected tag IDs
  • filters: dynamic filter rules
  • all_subscribed: broad send to subscribed contacts
Current implementation note:
  • filter audience can be stored, but send may return a validation error depending on environment rollout.

Launch And Monitoring

When a campaign is launched:
  1. Recipients are materialized.
  2. Queue chunks are created.
  3. Worker processes queue in batches.
  4. Final status becomes sent or failed after terminal outcomes.
Useful outcomes to monitor:
  • queued_count
  • sent_count
  • failed_count
  • open_rate
  • click_rate

Common Failures

  • sender domain not verified
  • provider configuration missing
  • account send limits reached
  • invalid or empty audience

Operational Best Practices

  1. Run a send-preview before launch.
  2. Start with tag or contact audience for predictable delivery.
  3. Schedule production sends with timezone awareness.
  4. Watch queue and recipient-level outcomes for first launch.