Setup Guide
This guide walks you through the full setup — from connecting your Klaviyo account to sending your first test delivery.
1. Connect your Klaviyo account
Section titled “1. Connect your Klaviyo account”- Go to klaviyo.alvaapps.com and click Connect with Klaviyo.
- You’ll be redirected to Klaviyo to authorize the app.
- Review the permissions and click Allow.
- You’ll be redirected back to Alva and taken to the onboarding flow.
2. Upload your files
Section titled “2. Upload your files”- On the onboarding screen (or later from Files in the sidebar), click Upload Files.
- Drag and drop files or click to browse. You can upload up to 10 files at a time.
- Supported formats include PDFs, images, videos, audio files, and archives (ZIP, RAR).
- Each file gets a title (defaults to the filename) that you can edit later.
File size limits depend on your plan:
| Plan | Max file size |
|---|---|
| Free | 50 MB |
| Starter | 512 MB |
| Growth | 2 GB |
| Scale | 10 GB |
3. Create a Download Bundle
Section titled “3. Create a Download Bundle”A Download Bundle groups one or more files together for delivery.
- Go to Download Bundles > New Bundle (or continue through onboarding).
- Enter a name for the bundle (e.g., “Photography Presets Pack”).
- Optionally add a description.
- Choose a download type:
- Individual — customers download each file separately.
- ZIP — all files are bundled into a single ZIP download.
- Select the files to include and arrange their order.
- Click Create.
Each bundle automatically gets a webhook endpoint URL and webhook secret — you’ll need these for the Klaviyo integration.
4. Set up the Klaviyo webhook
Section titled “4. Set up the Klaviyo webhook”This is how Klaviyo tells Alva to deliver files. See the full Klaviyo Integration Guide for detailed steps.
Quick version:
- In Klaviyo, open (or create) the flow where you want to deliver files.
- Add a Webhook action to the flow.
- Set the webhook URL to the endpoint URL shown in your bundle (or in Settings > Webhook Configuration).
- Add a custom header:
x-alva-webhook-secretwith the secret value from your settings. - Save the flow.
5. Send a test delivery
Section titled “5. Send a test delivery”- In the onboarding flow (or from Settings > Webhook Configuration), click Send Test.
- Select the bundle and enter an email address.
- Alva will process the test delivery and show you the download page URL.
- Click the URL to see your branded download page.
Next steps
Section titled “Next steps”- Customize your download page with your brand colors and logo
- Learn about delivery tracking to monitor your downloads
- Review plans to find the right tier for your volume