Integrations¶
GiftCard Hero can connect to external platforms to extend how gift card events are delivered.
Go to Settings → Integrations.
Current scope
The Klaviyo integration currently works only with Unused Balance Reminders. Support for promotions, mass send, and loyalty is planned.
Klaviyo¶
Klaviyo is an event-based marketing platform. Instead of GiftCard Hero sending the reminder email, GiftCard Hero sends an event to your Klaviyo account, and a Flow that you build in Klaviyo sends the actual email. This lets you use your own branding, segmentation, and A/B testing.
1. Get a Private API Key¶
In Klaviyo, go to Settings → API keys → Private API Keys → Create Private API Key.
Give the key a name (for example, GiftCard Hero) and grant these scopes — or simply choose Full Access:
- Events: Write — to send the reminder event
- Profiles: Write — the event creates or updates the customer profile
- Accounts: Read — used by the connection test
Copy the key (it starts with pk_). Klaviyo shows it only once.
2. Connect in GiftCard Hero¶
- Open Settings → Integrations.
- Paste the key into Private API key.
- Click Test connection — on success a banner shows your Klaviyo account name.
- Check Enable Klaviyo integration and click Save.
Your key is stored securely
The API key is stored encrypted and is never shown again. You only need to re-enter it if you want to replace it.
3. Use Klaviyo for reminders¶
In Reminders, set Delivery method to Klaviyo. From then on, eligible reminders send a Gift Card Reminder event to Klaviyo instead of an email from GiftCard Hero.
4. Build the Flow in Klaviyo¶
Create a Flow triggered by the Gift Card Reminder metric. Each event includes these properties you can use in the email:
| Property | Description |
|---|---|
gift_card_id |
Shopify gift card id |
card_masked |
Masked code, e.g. ••••1234 |
card_last4 |
Last 4 characters of the gift card code |
balance |
Remaining balance |
amount_used |
Amount already spent |
shop |
Store domain |
reminder_id |
Internal id (used to prevent duplicate events) |
The customer profile (email, first name, last name) is attached to the event automatically, so your Flow can match the customer and personalize the message.
The built-in template is not used
When Delivery method is Klaviyo, the GiftCard Hero reminder template is not sent — the email content is fully controlled by your Klaviyo Flow.
Notes¶
Consent¶
Reminders respect the Marketing consent filter in Reminder settings regardless of delivery method. Keep it enabled to comply with GDPR/CAN-SPAM and to avoid Klaviyo flagging your messages.
Fallback¶
If Klaviyo is selected but not usable — no key saved, the integration is disabled, or the saved key can't be used — GiftCard Hero falls back to sending the reminder through its built-in email, so customers still receive it.
What is not sent¶
The full, redeemable gift card code is not included in the event (Shopify does not expose it after the card is created). Use card_masked / card_last4 for display, and link customers to your store or account page so they can view and use the card.