Skip to content

Setup Guide

This guide walks you through the full setup — from connecting your Klaviyo account to sending your first test delivery.

  1. Go to klaviyo.alvaapps.com and click Connect with Klaviyo.
  2. You’ll be redirected to Klaviyo to authorize the app.
  3. Review the permissions and click Allow.
  4. You’ll be redirected back to Alva and taken to the onboarding flow.
  1. On the onboarding screen (or later from Files in the sidebar), click Upload Files.
  2. Drag and drop files or click to browse. You can upload up to 10 files at a time.
  3. Supported formats include PDFs, images, videos, audio files, and archives (ZIP, RAR).
  4. Each file gets a title (defaults to the filename) that you can edit later.

File size limits depend on your plan:

PlanMax file size
Free50 MB
Starter512 MB
Growth2 GB
Scale10 GB

A Download Bundle groups one or more files together for delivery.

  1. Go to Download Bundles > New Bundle (or continue through onboarding).
  2. Enter a name for the bundle (e.g., “Photography Presets Pack”).
  3. Optionally add a description.
  4. Choose a download type:
    • Individual — customers download each file separately.
    • ZIP — all files are bundled into a single ZIP download.
  5. Select the files to include and arrange their order.
  6. Click Create.

Each bundle automatically gets a webhook endpoint URL and webhook secret — you’ll need these for the Klaviyo integration.

This is how Klaviyo tells Alva to deliver files. See the full Klaviyo Integration Guide for detailed steps.

Quick version:

  1. In Klaviyo, open (or create) the flow where you want to deliver files.
  2. Add a Webhook action to the flow.
  3. Set the webhook URL to the endpoint URL shown in your bundle (or in Settings > Webhook Configuration).
  4. Add a custom header: x-alva-webhook-secret with the secret value from your settings.
  5. Save the flow.
  1. In the onboarding flow (or from Settings > Webhook Configuration), click Send Test.
  2. Select the bundle and enter an email address.
  3. Alva will process the test delivery and show you the download page URL.
  4. Click the URL to see your branded download page.