Skip to main content

Klaviyo setup and configuration

If you'd like to have some or all emails from Givy sent via Klaviyo, this article has everything you need to know

Enable the Integration

In Givy, go to the Integrations page, find Klaviyo, and click the Configure button.

Next, click the Connect with Klaviyo button

Click Continue

Click Allow

Now that your Klaviyo account is connected, click the Send test events button. This will generate all of the Givy events in your Klaviyo account so that you can more easily create flows and see sample event data.

To decide which Givy emails should be sent via Klaviyo, click the Manage individual emails button, which will open the Emails page in Givy.

Start Sending with Klaviyo

Now that the integration is active, you can start sending events to your Klaviyo account. While testing, we recommend using the setting Givy & Klaviyo, which will continue sending emails via Givy while you configure your Klaviyo emails.

You can decide which emails will be sent to Klaviyo by clicking the pencil icon and making your selection.

Events will now start being sent to Klaviyo. For each email event that is configured to use Klaviyo, we recommend creating an email template and Flow in your Klaviyo account.

To see the data sent in each event, see the Payload Data section below.

Finalize the Integration

When you have thoroughly tested your integration, we recommend enabling the Klaviyo Flow, and having these events sent only via Klaviyo. To do this, on the Emails page, change the setting from Givy & Klaviyo to only Klaviyo.

Creating Flows in Klaviyo

You will want to create a flow for each of the events you want to handle in Klaviyo, such as "Gift Card Created", "Gift Card Gifted - Email", etc...

We recommend the following:

  • Create Flow

  • Build Your Own

  • Name it, and choose Create manually

  • When selecting a trigger, select Your metrics, then API, and choose the Givy trigger for this flow. ** If the metrics do not appear here yet, you'll need to create a gift / gift card which sends this trigger before it will appear

  • Next, drag an email under the trigger to send an email

  • You will need to edit the email, choose a template, then edit the email with the information you want to add to the email

Including Givy data in emails

When building your emails, you will want to include information about the gift or gift card that was sent.

To include information which Givy sent to Klaviyo, use the format:

{{ event.givy_data_name }}

Here are some common variables you might want to include in your emails:

Sender name: {{ event.givy_purchaser_name }}
Recipient name: {{ event.givy_recipient_name }}
Gift card amount: {{ event.givy_gift_value }}
Three-letter currency: {{ event.givy_gift_value_currency }}
Link to redeem gift: {{ event.givy_redemption_url }}
Image URL: {{ event.givy_gift_card_image }}
Message: {{ event.givy_custom_message }}

You can see a full list of variables that can be used for each metric in the Payload Data below.

Payload Data

Each email will have its own set of data. Use this information to build customized emails in Klaviyo. These are sent as properties, and will appear in the event details for the Klaviyo account.

Gift Card Created

  • Event Name: Gift Card Created

  • Profile Used: Purchaser

"givy_gift_card_code" => "card_code_here"
"givy_gift_card_image" => "https://app-host-name.com/media/card.jpg"
"givy_gift_card_expiry" => null
"givy_gift_value" => "123.00"
"givy_gift_value_currency" => "USD"
"givy_sent_as_gift" => false

Gift Card Gifted (Email)

  • Event Name: Gift Card Created - Email Delivery

  • Profile Used: Recipient

"givy_recipient_email" => "[email protected]"
"givy_recipient_name" => "Kate"
"givy_purchaser_email" => "[email protected]"
"givy_purchaser_name" => "Bob"
"givy_gift_card_code" => "card_code_here"
"givy_gift_card_image" => "https://app-host-name.com/media/card.jpg"
"givy_gift_card_expiry" => null
"givy_gift_value" => "123.00"
"givy_gift_value_currency" => "USD"
"givy_sent_as_gift" => true
"givy_send_method" => "EMAIL"
"givy_custom_message" => "adsfasdfasd"
"givy_gif_url" => null
"givy_view_message_url" => null
"givy_redemption_url" => "https://test.myshopify.com/a/givy/redeem/as9as"
"givy_purchase_session_locale" => null
"givy_purchase_session_currency" => null
"givy_origin_order_id" => "gid://shopify/Order/6030673805444"
"givy_origin_order_name" => "#1031"

Gift Card Gifted (Link)

  • Event Name: Gift Card Created - Link Delivery

  • Profile Used: Purchaser

"givy_recipient_name" => "Kate"
"givy_purchaser_email" => "[email protected]"
"givy_purchaser_name" => "Bob"
"givy_gift_card_code" => "fasfasdfasdfasd"
"givy_gift_card_image" => "https://app-host-name.com/grey_gift_card.jpg"
"givy_gift_card_expiry" => null
"givy_gift_value" => "123.00"
"givy_gift_value_currency" => "USD"
"givy_sent_as_gift" => true
"givy_send_method" => "UNIQUE_LINK"
"givy_custom_message" => "adsfasdfasd"
"givy_gif_url" => null
"givy_view_message_url" => null
"givy_redemption_url" => "https://short.com/K8sh2H2"
"givy_purchase_session_locale" => null
"givy_purchase_session_currency" => null
"givy_origin_order_id" => "gid://shopify/Order/6030673805444"
"givy_origin_order_name" => "#1031"

Gift Card Gifted (Print)

  • Event Name: Gift Card Created - Print Delivery

  • Profile Used: Purchaser

"givy_recipient_name" => "Kate"
"givy_purchaser_email" => "[email protected]"
"givy_purchaser_name" => "Bob"
"givy_gift_card_code" => "fasfasdfasdfasd"
"givy_gift_card_image" => "https://app-host-name.com/grey_gift_card.jpg"
"givy_gift_card_expiry" => null
"givy_gift_value" => "123.00"
"givy_gift_value_currency" => "USD"
"givy_sent_as_gift" => true
"givy_send_method" => "PRINT"
"givy_custom_message" => "adsfasdfasd"
"givy_gif_url" => null
"givy_view_message_url" => null
"givy_redemption_url" => "https://short.com/K8sh2H2"
"givy_purchase_session_locale" => null
"givy_purchase_session_currency" => null
"givy_origin_order_id" => "gid://shopify/Order/6030673805444"
"givy_origin_order_name" => "#1031"

Merchandise Gifted (Email)

  • Event Name: Merchandise Gifted - Email Delivery

  • Profile Used: Recipient

"givy_recipient_email" => "[email protected]"
"givy_recipient_name" => "Kate"
"givy_purchaser_email" => "[email protected]"
"givy_purchaser_name" => "Bob"
"givy_product_image" => "https://image.com/thing-one/thing-two.png"
"givy_product_name" => "Really Cool Product"
"givy_product_variant_name" => "Cool variant"
"givy_product_quantity" => 1
"givy_gift_value" => "250.00"
"givy_gift_value_currency" => "USD"
"givy_sent_as_gift" => true
"givy_send_method" => "EMAIL"
"givy_custom_message" => "adsfasdfasd"
"givy_gif_url" => null
"givy_view_message_url" => null
"givy_redemption_url" => "https://test.myshopify.com/a/givy/redeem/abc"
"givy_purchase_session_locale" => null
"givy_purchase_session_currency" => null
"givy_origin_order_id" => "gid://shopify/Order/6030673805444"
"givy_origin_order_name" => "#1031"

Merchandise Gifted (Link)

  • Event Name: Merchandise Gifted - Link Delivery

  • Profile Used: Purchaser

"givy_recipient_name" => "Kate"
"givy_purchaser_email" => "[email protected]"
"givy_purchaser_name" => "Bob"
"givy_product_image" => "https://image.com/thing-one/thing-two.png"
"givy_product_name" => "Really Cool Product"
"givy_product_variant_name" => "Cool variant"
"givy_product_quantity" => 1
"givy_gift_value" => "250.00"
"givy_gift_value_currency" => "USD"
"givy_sent_as_gift" => true
"givy_send_method" => "UNIQUE_LINK"
"givy_custom_message" => "adsfasdfasd"
"givy_gif_url" => null
"givy_view_message_url" => null
"givy_redemption_url" => "https://short.com/K8sh2H2"
"givy_purchase_session_locale" => null
"givy_purchase_session_currency" => null
"givy_origin_order_id" => "gid://shopify/Order/6030673805444"
"givy_origin_order_name" => "#1031"

Merchandise Gifted (Print)

  • Event Name: Merchandise Gifted - Print Delivery

  • Profile Used: Purchaser

"givy_recipient_name" => "Kate"
"givy_purchaser_email" => "[email protected]"
"givy_purchaser_name" => "Bob"
"givy_product_image" => "https://image.com/thing-one/thing-two.png"
"givy_product_name" => "Really Cool Product"
"givy_product_variant_name" => "Cool variant"
"givy_product_quantity" => 1
"givy_gift_value" => "250.00"
"givy_gift_value_currency" => "USD"
"givy_sent_as_gift" => true
"givy_send_method" => "PRINT"
"givy_custom_message" => "adsfasdfasd"
"givy_gif_url" => null
"givy_view_message_url" => null
"givy_redemption_url" => "https://short.com/K8sh2H2"
"givy_purchase_session_locale" => null
"givy_purchase_session_currency" => null
"givy_origin_order_id" => "gid://shopify/Order/6030673805444"
"givy_origin_order_name" => "#1031"

Gift Sent

  • Event Name: Notification - Gift Sent

  • Profile Used: Purchaser

"givy_recipient_email" => "[email protected]",
"givy_recipient_name" => "Kate",
"givy_purchaser_email" => "[email protected]",
"givy_purchaser_name" => "Bob",
"givy_gift_value" => "123.00",
"givy_gift_value_currency" => "USD",
"givy_sent_as_gift" => true,
"givy_send_method" => "EMAIL",
"givy_custom_message" => null,
"givy_gif_url" => null,
"givy_view_message_url" => null,
"givy_purchase_session_locale" => null,
"givy_purchase_session_currency" => null,
"givy_gift_card_code" => "fasfasdfasdfasd",
"givy_gift_card_image" => "https://app-host-name.com/grey_gift_card.jpg",
"givy_gift_card_expiry" => null,

Gift Redeemed

  • Event Name: Notification - Gift Redeemed

  • Profile Used: Purchaser

"givy_recipient_email" => "[email protected]",
"givy_recipient_name" => "Kate",
"givy_purchaser_email" => "[email protected]",
"givy_purchaser_name" => "Bob",
"givy_gift_value" => "123.00",
"givy_gift_value_currency" => "USD",
"givy_sent_as_gift" => true,
"givy_send_method" => "EMAIL",
"givy_custom_message" => null,
"givy_gif_url" => null,
"givy_view_message_url" => null,
"givy_purchase_session_locale" => null,
"givy_purchase_session_currency" => null,
"givy_gift_card_code" => "fasfasdfasdfasd",
"givy_gift_card_image" => "https://app-host-name.com/grey_gift_card.jpg",
"givy_gift_card_expiry" => null,

Gift Used

  • Event Name: Notification - Gift Used

  • Profile Used: Purchaser

"givy_recipient_email" => "[email protected]",
"givy_recipient_name" => "Kate",
"givy_purchaser_email" => "[email protected]",
"givy_purchaser_name" => "Bob",
"givy_gift_value" => "123.00",
"givy_gift_value_currency" => "USD",
"givy_sent_as_gift" => true,
"givy_send_method" => "EMAIL",
"givy_custom_message" => null,
"givy_gif_url" => null,
"givy_view_message_url" => null,
"givy_purchase_session_locale" => null,
"givy_purchase_session_currency" => null,
"givy_gift_card_code" => "fasfasdfasdfasd",
"givy_gift_card_image" => "https://app-host-name.com/grey_gift_card.jpg",
"givy_gift_card_expiry" => null,

Did this answer your question?