> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help-new.virtueimpact.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Klaviyo integration

Engaging your customers with the impact that their purchase has made is key to running a successful giving campaign. Connecting Virtue with Klaviyo makes this easier than ever!

## Merchants using Virtue and Klaviyo can:

* Share donation values and impact of orders with customers.
* Update customers on the total giving / impact generated by a campaign
* Share the total giving and impact from all of individual customer's orders.

## To get started create an API key

First you will need to create an API key from within Klaviyo to use with Virtue.

1. Navigate to API Keys under [profile settings](https://www.klaviyo.com/account#api-keys-tab).
2. Click **[Create Private API Key]**
3. Enter "Virtue" as your Private API Key Name
Under Select Access Level, select **Full Access Key**

[![](https://storage.crisp.chat/users/helpdesk/website/-/3/4/7/6/3476b04c12763e00/c11ee385-a495-480f-bae3-93c970_1oxrib9.png)](https://downloads.intercomcdn.com/i/o/885065523/0ded5e313e76274d7d41b944/klaviyo_create_api_key.png?expires=1765979100&signature=cd2ee904632e0c4a08d0be1a315b16ff431cb29a42cfed2653c1b224c35fea69&req=fCgiFs97mINcFb4f3HP0gLB9mhLVnIRIos4t4%2F%2BFrmy9zQF3QD8rZdNlhvuV%0Al4Y%3D%0A)

5. Click **Create.** This will generate your new API key.
6. Click the [copy] button to copy your API key.

[![](https://storage.crisp.chat/users/helpdesk/website/-/b/1/0/e/b10e477b93430800/9afb4bee-903b-472a-8c1f-aba5cd_bsef9i.png)](https://downloads.intercomcdn.com/i/o/885067660/302e68ec753b278baef6935a/klaviyo-copy-key.png?expires=1765979100&signature=32b3c39e018527a5d3b22c98548e13ab1d873848b41cbae92a72604ad8885090&req=fCgiFs95m4dfFb4f3HP0gG750OQNCx36ATOlwunSQTzLNldotgDeMfCIoxpK%0A59SaqN7JZHHeKl1FXg%3D%3D%0A)

## Connecting Klaviyo to Virtue

1. In Virtue go to [Integrations > Klaviyo.](https://app.virtueimpact.com/integrations/klaviyo)
2. Paste the API key you created previously and click **Save.**

[![](https://storage.crisp.chat/users/helpdesk/website/-/6/3/9/f/639fdae1b7756800/c7284d77-6595-4fbb-8bcf-30bc62_1fdvgwd.png)](https://downloads.intercomcdn.com/i/o/885071252/f4fe5167d24c8a9f0abe9507/klaviyo-paste-api-key.png?expires=1765979100&signature=9a67df57b03b7b0913c7b31ebf874154d02d8b97ac1fc823a3ae382379696747&req=fCgiFs5%2Fn4RdFb4f3HP0gO1c1InAVeMjC9w6hKN4l5NEiS8GVvSzNAImymmc%0AC%2B3l%2BK7OGQfe39ohbA%3D%3D%0A)

## Sending a Giving confirmation email / message

Whenever an order is made on your store that includes giving the "Ordered with donation" event is sent on the customer's profile.

To setup a giving confirmation email / message create a new flow and set the trigger to the metric event called **Ordered with donation**.

[![](https://storage.crisp.chat/users/helpdesk/website/-/3/6/8/b/368b723e962c3e00/905500b6-be1b-4edb-b4ce-2d0a80_wdoae6.png)](https://downloads.intercomcdn.com/i/o/886000938/b49306adb5557b6eba466878/klaviyo-ordered-w-giving.png?expires=1765979100&signature=13035aec0512282df1fea647e1998862e8aa3f6d0edbf8d8aaa87c8cb3cb0678&req=fCghFsl%2BlIJXFb4f3HP0gCK67GW1NY7svB4%2FLaPmn0tgTSrCiRsbBv4V4eiM%0A1eA%3D%0A)

2. All of the giving, calculated impact and cause details for the order are attached to this event. Below is a breakdown of each field provided and the syntax to use inside of your email / message.

| Event field | Email / message syntax |
| --- | --- |
| Order total donation amount | {{ event.order_total_giving_amount|default:'' }} |
| Order donation amount given by the store | {{ event.order_total_store_giving_amount|default:'' }} |
| Order donation amount given by the customer | {{ event.order_total_customer_giving_amount|default:'' }} |
| Order total calculated impact amount (when the cause has calculated impact) | {{ event.order_total_impact|default:'' }} |
| Order calculated impact amount from the store giving (when the cause has calculated impact) | {{ event.order_total_store_impact|default:'' }} |
| Order calculated impact amount from the customer giving (when the cause has calculated impact) | {{ event.order_total_customer_impact|default:'' }} |
| Campaign current total donation amount | {{ event.store_running_total_giving_amount|default:'' }} |
| Campaign current total impact amount (when the order's chosen cause has calculated impact) | {{ event.store_running_total_impact|default:'' }} |
| Name of the cause | {{ event.cause_name|default:'' }} |
| Organization name of the cause | {{ event.cause_organization|default:'' }} |
| Description of the cause | {{ event.cause_description|default:'' }} |
| Icon for the cause | {{ event.cause_icon|default:'' }} |
| Website url of the cause | {{ event.cause_website|default:'' }} |
| Order - all fields from the order provided by the ecommerce platform. (The name of this field is formatted as the ecommerce platform_order ie. shopify_order. | {{ shopify|magento|woocommerce_order }} |

## Using a customer's total giving from all of their orders in your emails / messages

To share the total giving that has taken place from all of a customer's orders with you follow these steps:

1. Open the email / message editor for your flow or campaign email / message.
2. Select [**Add personalization**] and scroll down to "**Custom**".
3. You can insert the below fields from the customer profile.

| Profile field | Email / message syntax |
| --- | --- |
| Total donations amount from all of the customer's orders. | .{{ person|lookup:"total_giving_amount"|default:"" }} |
| Total donations made by this customer for their orders. | {{ person|lookup:"total_customer_giving_amount"|default:"" }} |
| Total donations made by the store for this customer's orders. | {{ person|lookup:"total_store_giving_amount"|default:"" }} |