Documentation / Settings / Email sharing with Klaviyo

Email sharing with Klaviyo

Set up preview email sharing using Klaviyo as your email provider

Overview

Klaviyo lets you send beautifully designed preview emails using your existing Klaviyo account. When a shopper shares their preview via email, Instant Art Kit sends an event to Klaviyo which triggers a Flow that delivers the email.

Prerequisites

  • Instant Art Kit installed and configured
  • A Klaviyo account connected to your Shopify store

Step 1: Get your Klaviyo private API key

  1. Log in to your Klaviyo account
  2. Go to Settings > API Keys
  3. Click Create Private API Key
  4. Give it a descriptive name (e.g., “Instant Art Kit”)
  5. Make sure the key has Full Access to Events (required to send preview events)
  6. Copy the generated API key

Store your API key somewhere safe. Once you leave this page, Klaviyo won’t show the full key again.

Step 2: Configure Instant Art Kit

  1. In your Shopify admin, go to Apps > Instant Art Kit > Settings
  2. In the Preview sharing section, check Email button
  3. Select Klaviyo as the email provider
  4. Click Add API key and paste your Klaviyo private API key
  5. Click Save in the modal, then save your settings

Step 3: Send a test email to register the event

Before you can create a Flow in Klaviyo, the Preview Email Requested event needs to exist in your Klaviyo account. Klaviyo registers new API events automatically when they are first received.

  1. Go to a product page on your storefront that has Instant Art Kit enabled
  2. Generate a preview
  3. Click the Email button and enter a test email address
  4. This sends the first event to Klaviyo and registers it under your API metrics

This step is required. Klaviyo won’t show the event as a trigger option until it has received at least one event.

Step 4: Create a Klaviyo Flow

  1. In your Klaviyo account, go to Flows
  2. Click Create Flow > Build from scratch
  3. For the trigger, select API as the source
  4. Search for Preview Email Requested in the event list
  5. Select it and click Done

Step 5: Add an email action

  1. Click the + button below the trigger
  2. Select Email as the action
  3. Design your email template

Available event data

The event includes the following properties you can use in your Klaviyo email template:

VariableDescriptionExample
event.productUrlLink to the product page with the preview pre-loadedhttps://yourstore.com/products/diamond-painting?iak_uuid=...
event.previewImageUrlDirect URL to the generated preview imagehttps://api.instantartkit.com/api/files/.../preview

The customer email is used as the event profile, so Klaviyo automatically sends to the right recipient.

Designing the email template

  • Add the preview image using the event.previewImageUrl property as the image source
  • Add a call-to-action button linking to event.productUrl so the customer can return to the product with their preview loaded
  • The productUrl includes deep-link parameters that automatically open the preview modal when the customer visits the page

Step 6: Activate the Flow

  1. Review your Flow to make sure the trigger and email action are connected
  2. Set the Flow status to Live
  3. Your Klaviyo email automation is now active

Testing

  1. Go to a product page on your storefront
  2. Generate a preview and share it via email
  3. Check Klaviyo’s Activity Feed to confirm the event was received
  4. Verify the email arrives with the correct preview image and product link

If the event doesn’t appear in Klaviyo, verify your API key is correct in the Instant Art Kit settings. You can replace it at any time from the settings page.