The Klaviyo integration sends Wrapped gift card events, such as Wrapped: Gift Card Issued, to the recipient's profile in Klaviyo. Each event carries the gift card's code, balance, expiry and links, so you can trigger Klaviyo flows and build gift card emails in Klaviyo. It's included on the Pro plan and above, and you connect it at Settings › Integrations and API keys.
The integration sends events to Klaviyo. To create gift cards from a Klaviyo flow, also set up the Klaviyo flow action.
Connect Klaviyo
You need to be an Owner or Admin in Wrapped, and able to approve app access in your Klaviyo account.
- Go to Settings › Integrations and API keys.
- On the Klaviyo row, click Install.
- Klaviyo opens. Sign in if asked, check you're in the right Klaviyo account, and click Allow.
- You're returned to Wrapped with the message "Klaviyo is connected.", and the Klaviyo row shows Installed.
Wrapped asks Klaviyo for permission to read your Klaviyo account details and to read and write events and profiles. If you decline any permission, Wrapped shows "We couldn't connect Klaviyo. Reconnect and accept every permission it asks for." Click Install again and accept them all.
Events start from the moment you connect. Gift cards and changes from before then aren't sent to Klaviyo.
Events sent to Klaviyo
Every event is added to the Klaviyo profile for the gift card's recipient email address. Gift cards without a recipient email address don't send events.
| Metric in Klaviyo | Sent when |
|---|---|
| Wrapped: Gift Card Issued | A gift card is created and Wrapped sends its gift card notifications, for example after a sale at a connected sales channel, a web store purchase or issuing a card from the dashboard. |
| Wrapped: Gift Card Updated | A gift card's balance has changed from its starting value and Wrapped sends its notifications, for example after a redemption or a top-up. |
| Wrapped: Gift Card Reminder | Wrapped sends a balance reminder for a gift card. |
| Wrapped: Gift Card Gifted | A gift card is delivered to its recipient as a gift, including scheduled gift deliveries. |
| Wrapped: Gift Card Voided | A gift card is voided. |
| Wrapped: GiftCardExpired | A gift card expires. (The metric name has no spaces.) |
| Wrapped: Klaviyo Flow: flow ID | A gift card is created by a Klaviyo flow action. |
Wrapped sends the event whether or not the matching Wrapped email is turned on. Each successful event is also recorded on the gift card's timeline, for example "'gift card issued' event sent to Klaviyo".
Event properties
| Property | What it contains |
|---|---|
code | The gift card code |
gift_card_id | Wrapped's ID for the gift card |
initial_value | The starting value, formatted with the currency |
balance | The current balance, formatted with the currency |
total_issued_amount | Everything ever loaded onto the card (starting value plus top-ups), formatted |
currency | The currency code, for example USD |
expiration_date | The expiry date and time in UTC, or empty if the card doesn't expire |
status | The card's status, for example Active, Redeemed, Expired or Voided |
apple_wallet_url | Link to add the card to Apple Wallet |
google_wallet_url | Link to save the card to Google Wallet |
pdf_url | Link to the printable gift card PDF |
view_balance_url | Link to your check balance page with the code filled in |
gift_to_friend_url | Link to your gift to a friend page for this card |
topup_url | Link to top up the card on your web store (only useful if your web store allows top-ups) |
buyer_name, buyer_email | Who bought the card; if no buyer was recorded, the recipient's name and email |
gift_card_message | The gift message, if there is one |
gift_image_url | The image chosen for the gift, if there is one |
is_promotional | true for promotional cards such as bonus gift cards and giveaways |
gift_card_batch_id, automation_id, campaign_id | The batch, automation or campaign that created the card, if any |
api_event_name, api_event.key | For cards created by an API event automation: the event name and each property sent with it |
klaviyo_campaign_name | Only on the Klaviyo Flow event |
In a Klaviyo email template, use a property as {{ event.code }} or {{ event.balance }}.
gift_card_message may contain HTML. Add the safe filter so it displays properly: {{ event.gift_card_message|safe }}.
Build a flow from a Wrapped event
- In Klaviyo, create a flow from scratch.
- Choose a metric trigger and pick a Wrapped metric, for example Wrapped: Gift Card Issued. A metric only appears in Klaviyo after Wrapped has sent that event at least once.
- Add your conditions, delays and emails, using the event properties above.
- Turn the flow on.
If Klaviyo sends the gift card email, turn off the matching Wrapped email under Branding › Emails, or the customer receives both. Wrapped still sends the event to Klaviyo when its own email is off. See Customize your gift card emails.
Test the integration
- Connect Klaviyo as above.
- Issue a gift card from the dashboard with your own email address as the recipient. See Issue a gift card from the dashboard.
- In Klaviyo, open your profile. A Wrapped: Gift Card Issued event appears.
- In Wrapped, open the gift card and void it.
- Back in Klaviyo, a Wrapped: Gift Card Voided event appears on your profile.
Voided test cards don't count toward your monthly gift card allowance.
Reconnect or disconnect Klaviyo
- If the Klaviyo row shows Connection error, Wrapped can no longer reach your Klaviyo account (for example, the app's access was removed in Klaviyo). Click Reconnect and accept the permissions again. Events aren't sent while the connection is broken, and events missed during that time aren't sent later.
- To disconnect, click Disconnect on the Klaviyo row, then Disconnect in Disconnect Klaviyo?. Gift card events stop, and any Klaviyo flow action stops creating gift cards. Events already in Klaviyo stay there. You can install it again at any time.
Common questions
Why isn't an event showing on a customer's profile?
Check that the gift card has a recipient email address, that the Klaviyo row shows Installed rather than Connection error, and look at the gift card's timeline for a "sent to Klaviyo" entry. Events are only sent while your Wrapped subscription is active.
Why didn't a balance change send a Gift Card Updated event?
Updated events are sent when Wrapped sends its gift card notifications for the change. Balance adjustments added through the Wrapped API don't send notifications, so they don't send an event.
Does Wrapped create or update Klaviyo profiles?
Wrapped sends each event with the recipient's email address, and Klaviyo adds it to the profile with that email, creating the profile if it doesn't exist.
Can I send my past gift cards to Klaviyo?
No. Only events that happen after you connect are sent.
Does the Klaviyo integration use my gift card allowance?
No. Sending events doesn't create gift cards. Gift cards created by a Klaviyo flow action do count; see Issue gift cards from a Klaviyo flow.