Help

Backups and recovery.

Newsletter Sender automatically backs up your entire account every night. Here is what gets backed up, where your snapshots are stored, and how to restore them if you ever need to.

All help

1Nightly automated backups

Every night at 02:00, Newsletter Sender saves a complete snapshot of your data directly to your Cloudflare storage. This includes your lists, subscribers, campaigns, templates, automations, reports and settings. The last 30 daily backups are retained automatically.

Sensitive credentials, including API keys and passwords, are strictly excluded, making downloaded copies safe to store offline.

  1. Go to Settings → Backups to view all snapshots along with their creation date, record count and file size.
  2. Click Back up now to trigger an instant snapshot. Recommended before making major list changes. These entries are tagged as Backed up manually.
  3. Click Download next to any entry to save an offline archive. Files are exported as a compressed .ndjson.gz archive. An active account with 100,000 subscribers and a year of weekly sends is typically around 225 MB.

2Off-site backups outside Cloudflare

If you send via Amazon SES, every nightly backup is automatically mirrored to a private S3 bucket inside your own AWS account. The setup wizard creates and configures this bucket for you automatically, retaining each archive for 31 days.

To access them, log in to the AWS Management Console, navigate to S3 and open the bucket named newsletter-sender-backups-*. From there, simply select an archive and click Download.

Sending with Postmark, Mailgun, Brevo or Resend? Because off-site S3 copies are exclusive to Amazon SES accounts, make a habit of downloading backups from your dashboard and archiving them locally or in your preferred cloud storage provider.

3Restoring a backup

  1. Go to Settings → Backups and click Restore next to the snapshot you want to recover.
  2. Confirm by clicking Yes, restore this backup. Your entire account (lists, campaigns and settings) will revert to that point in time. A fresh safety snapshot of your current state is created automatically before restoring begins, so you can always revert if needed.
Campaign sending right now? Restoring is locked while a campaign is sending. Either pause the campaign or wait for it to finish before rolling back.

4Restoring from an archive file

Use this to restore a previously downloaded backup or a snapshot retrieved from your Amazon S3 bucket.

  1. Go to Settings → Backups and click Restore from file.
  2. Select your .ndjson.gz archive. Larger files are uploaded in parts, with progress shown as it goes.
  3. Click Yes, restore from file. Newsletter Sender checks the file is a Newsletter Sender backup before restoring. Anything else is safely turned down without affecting your data.

5Moving to a new Cloudflare account

If you ever need to move to, or recover access via, a new Cloudflare account, your entire newsletter comes with you:

  1. Install Newsletter Sender on your new Cloudflare account.
  2. Go to Settings → Backups → Restore from file and upload your most recent .ndjson.gz backup from your local downloads or your S3 bucket.
  3. Go to Settings → Sending and re-enter your sending service's API key. Credentials are never stored inside backup files, for security. Once you add the key again, you're connected straight back to your existing setup, including Amazon SES.
Back: sign up confirmationsNext: use the API