Klaviyo Events Reference

Alva fires events to your Klaviyo account at key points in the delivery lifecycle. Use these events to trigger email flows, segment customers, and build reports.

Alva Download Ready

Fired when a delivery is approved and the download link is generated.

Use this event to trigger your download email flow.

Property	Type	Description
DownloadPageURL	string	The customer’s unique download page URL
ProductName	string	Name of the download bundle
FileCount	number	Number of files in the bundle
ExpiresAt	string	When the download link expires (ISO 8601)
MaxDownloads	number	Maximum downloads allowed
Files	array	List of files with names, types, and sizes

Example email template usage:

Hi {{ person.first_name }},

Your download is ready!

{{ event.ProductName }} ({{ event.FileCount }} files)

{{ event.DownloadPageURL }}

This link expires on {{ event.ExpiresAt }}.

Alva Delivery Blocked

Fired when a delivery is blocked by fraud detection.

Property	Type	Description
ProductName	string	Name of the download bundle
Reason	string	Why the delivery was blocked
FraudScore	number	The fraud score (0-100)

Note

You typically don’t need to create a flow for this event. It’s useful for internal monitoring or alerting.

Alva Download Completed

Fired each time a customer downloads an individual file.

Property	Type	Description
FileName	string	Name of the downloaded file
FileType	string	File category (DOCUMENT, IMAGE, etc.)
FileSizeMB	number	File size in megabytes
RemainingDownloads	number	Downloads remaining on the token

Alva All Files Downloaded

Fired when a customer has downloaded every file in the bundle.

Property	Type	Description
ProductName	string	Name of the download bundle
TotalFiles	number	Total files in the bundle
CompletionTimeMinutes	number	Time from first to last download

Tip

Use this event to trigger a follow-up email (e.g., “How did you like your download?”) or to segment customers who completed their downloads.

Alva Download Link Expired

Fired when a download token expires.

Property	Type	Description
ProductName	string	Name of the download bundle
WasPartiallyDownloaded	boolean	Whether some (but not all) files were downloaded
FilesDownloaded	number	Number of files the customer downloaded before expiry

Tip

Use this to identify customers who may need a new link. If WasPartiallyDownloaded is true, the customer started downloading but didn’t finish — you might want to send them a new link.

Using events in Klaviyo

Creating a flow

1. In Klaviyo, go to Flows > Create Flow.
2. Choose Build from Scratch.
3. Set the trigger to the desired Alva event (e.g., “Alva Download Ready”).
4. Add your email action and use the event properties in your template.

Segmenting with events

You can create segments based on Alva events. For example:

• Customers who have received at least one download (triggered “Alva Download Ready”).
• Customers who downloaded all files (triggered “Alva All Files Downloaded”).
• Customers whose links expired without downloading (triggered “Alva Download Link Expired” where WasPartiallyDownloaded is false).

Custom metrics

Alva events appear as custom metrics in Klaviyo. They’re created automatically the first time each event type is fired — no manual setup needed.