Skip to main content
FluxoMail supports scheduling campaigns to send later. You can toggle scheduling in the Review step and provide a local date/time. At the scheduled time, your environment’s cron triggers FluxoMail to deliver the campaign.

Enable Scheduling in the App

  1. Compose a campaign → Review
  2. Check “Send later” and pick a local date/time
  3. Click “Schedule Campaign”
The campaign status becomes scheduled and appears in your Campaigns list.

Wire the Scheduler to Your Cron

  • Endpoint: GET /api/scheduler/run
  • Auth: header X-Cron-Secret: <CRON_SECRET>
Example (GitHub Actions or any cron runner):
curl -sSf -H "X-Cron-Secret: $CRON_SECRET" https://your-app.com/api/scheduler/run
Recommended cadence: every 1–5 minutes.

How It Works

  • The scheduler lists campaigns with status scheduled whose scheduledAt ≤ now and sends them using your active sender profile and policies.
  • Guardrails (warm‑up caps, complaint/delivery thresholds for bulk) still apply.

Troubleshooting

  • “Nothing processed”: ensure CRON_SECRET matches your server env and your cron actually hits the endpoint.
  • “Domain not verified”: complete domain verification under Domains before scheduling.