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.
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
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,