> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mailerpath.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Campaigns

> Create, schedule, send, and monitor one-time email campaigns.

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

Use campaigns when you want a controlled broadcast, not an event-driven sequence. They are best for announcements, promotions, and operational updates that should reach a specific audience at a specific time.

## Campaign Lifecycle

Campaign statuses:

* draft
* scheduled
* processing
* sent
* failed
* cancelled

## Create Campaign Checklist

Before launch, confirm that the audience is intentional, the template is ready, and the send window matches the recipient timezone.

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.