Skip to main content
Klaviyo

1. How to setup Klaviyo

Connect Klaviyo to Giftnote, send test events, choose and rename the events Klaviyo receives, and the merge fields to use in your gift emails.

Written By Giftnote Admin

Last updated 1 day ago

Connect Klaviyo and Giftnote tells Klaviyo each time a gift is ordered, delivered or received, so your gift emails go out from Klaviyo in your own designs. Each of these updates is an "event". You build a Klaviyo flow (an automated email) that starts when the event arrives.

Settings โ†’ Integrations โ†’ Klaviyo: connection, Integration Enabled and notification events.

Before you start

You will need:

  • Access to the Giftnote app in your Shopify admin
  • A Klaviyo login that can approve app connections for the right Klaviyo account

Connect Klaviyo

  1. Open the Giftnote app inside your Shopify admin.
  2. Go to Settings โ†’ Integrations. Find Klaviyo under Available, in the Marketing section, and select Connect. If it is already connected, itโ€™s under Connected: select Manage settings.
  3. Select Connect Klaviyo at the top of the page. Giftnote sends you to Klaviyo to approve the connection.
  4. Choose your account. If you have more than one Klaviyo account, pick the one for this store.
  5. Review the permissions and click Allow.
  6. Check the connection. Back in Giftnote, the top of the Klaviyo page reads Connected via OAuth, with a Disconnect button.

Signing in like this (OAuth) is the supported way to connect. If you canโ€™t use it, see Connect with a private API key instead, below.

Send test events and build your flows

  1. Send test events. On the Klaviyo page, select Send all test events to send one of each event that is switched on (every event, if none are). Or select Test on a single event: it shows once that eventโ€™s switch is on (see Turn on the integration, below). Events are grouped under Gift Orders, Gift Cards and Multi Gift.
  2. Check the events arrived in Klaviyo. Go to Metrics > Activity feed and look for the Giftnote events.
  3. Build a flow for each event you want to use, or email support@giftnote.com and we'll add our ready-made flows (see 4. Ready-made Klaviyo flows from Giftnote). In Klaviyo, create a flow and pick the Giftnote event as its trigger. For gift orders the events are Placed Gift Order, Gift Order Delivered and Received Gift Order. The full list is in Klaviyo Giftnote Events. To see who each event goes to (customer, recipient or staff), check its badge in Settings โ†’ Notifications.
  4. Rename an event if you need to. Select Edit on an event, then change Custom event name. That is the name Klaviyo receives (Klaviyo calls it the metric name), for example to match a flow you already have.

Connected Klaviyo before the September update?
Your existing flows keep working. If you used Giftnote before September 2026, your store keeps sending the old metric names, such as Giftnote - Order Scheduled and Giftnote - Order Tracked, which both map to Placed Gift Order. The Klaviyo page shows a Migrate to OAuth section marked Migration needed. Follow Migrating your Klaviyo flows to the new Giftnote integration to move over without duplicate emails, and use the current event names for any new flow.

Turn on the integration

  1. Choose your events. Each event has its own switch, for example Send Gift Order - Gift Message Delivered to Klaviyo. Leave it on for each event you have a flow for.
  2. Turn on Send events to Klaviyo if it is off. Save if a save bar appears.
  3. Turn off the matching Giftnote emails. In Settings โ†’ Notifications, turn off the Email switch on each notification Klaviyo now handles, so recipients donโ€™t get two emails.

To pause everything without disconnecting, turn off Send events to Klaviyo. Each event keeps its own setting for when you turn it back on.

Connect with a private API key instead

Signing in is the supported way to connect, and a private API key still works. Use a key only if you canโ€™t approve the connection from your Klaviyo login.

  1. Create a private API key in Klaviyo. In Klaviyo, open your accountโ€™s API keys settings and create a private key. Give it read and write access to events, flows and profiles, and read access to accounts.
  2. Paste it into Giftnote. On the Klaviyo page, paste the key into Private API key (it starts with pk_), then save.
  3. Check the connection. The top of the page reads Connected via private API key.

If you later want to sign in instead, the Klaviyo page walks you through it under Migrate to OAuth.

Pause sending, or disconnect

To pause everything and keep your settings, turn off Send events to Klaviyo. Disconnect at the top of the Klaviyo page also stops Giftnote sending events to Klaviyo. Nothing in your Klaviyo account is changed: your flows, metrics and profiles stay as they are.

Before you pause or disconnect, turn Giftnoteโ€™s own emails back on in Settings โ†’ Notifications for anything Klaviyo was sending. Otherwise recipients get nothing.

Email merge fields for Giftnote

Merge fields are placeholders that Klaviyo swaps for the real gift details when it sends the email. Paste them into your flow emails exactly as written. Field names are case-sensitive, and a typo shows up as a blank.

Message based gifts

Use these fields for standard gift messages.

  • {{ event|lookup:'Scheduled Time'|default:'' }}
  • {{ event.Message|default:'' }}
  • {{ event.To|default:'' }}
  • {{ event|lookup:'Delivery Method'|default:'' }}
  • {{ event.From|default:'' }}

Together they give you the send time, message, recipient, delivery method and sender. Scheduled Time can be missing on real orders, so keep the |default:''.

Gift card based gifts

Use these fields when the order includes a gift card.

  • {{ event|lookup:'Gift Card Code'|default:'' }}
  • {{ event|lookup:'Gift Card Value'|default:'' }}
  • {{ event|lookup:'Scheduled Time'|default:'' }}
  • {{ event|lookup:'Gift Card Sku'|default:'' }}
  • {{ event.Message|default:'' }}
  • {{ event|lookup:'Gift Card Expiry'|default:'' }}
  • {{ event.From|default:'' }}
  • {{ event|lookup:'Delivery Method'|default:'' }}

Together they give you the card code, value, SKU and expiry, plus the send time, message, sender and delivery method.

Example payloads

To see exactly what data an event sends from your store (its โ€œpayloadโ€), select Preview on that event on the Klaviyo page.