Create Private API Key
Before setting up your Klaviyo integration, please ensure that you already have a Klaviyo account correctly set up for your store. You'll need to create a new Private API Key from your Klaviyo dashboard. Be sure to copy the API key so that you can enter it into the Givy settings.
We recommend the following settings:
Name: Givy
Access Level: Custom
Accounts - Read/Write Access
Events - Read/Write Access
Metrics - Read/Write Access
For instructions on creating your own private API key, check out this Klaviyo article:
Enable the Integration
In Givy, go to the Integrations page, find Klaviyo, and click the Configure button.
Next, past your Klaviyo API key into the text field, and click Save. If the key is valid, the status of the integration will become Active.
Send Test Events to 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 even 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.
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
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
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
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
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
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
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,