Import ambassadors, map merge fields, and test attribution end-to-end before you start sending.
Export ambassadors from Refer Labs and import them into Klaviyo with the right custom properties.
Required properties
referral_code, referral_link, discount_code
Use the ambassador’s unique link as your primary CTA. Refer Labs tracks clicks automatically via UTM tags.
Example merge tags (Klaviyo)
Hi {{ first_name|default:"there" }},
Share your link:
{{ person.referral_link }}
Or use it as your button URL:
{{ person.referral_link }}If your account uses different tag syntax, keep the same property name: referral_link.
If your conversion event happens outside Shopify/Stripe and you want to report it directly, use a webhook action from a Klaviyo flow (server-to-server) and include the discount capture secret in headers.
Webhook target
POST https://referlabs.com.au/api/discount-codes/redeem
Headers:
Content-Type: application/json
x-pepf-discount-secret: <YOUR_SECRET>
Body:
{
"discountCode": "{{ person.discount_code }}",
"orderReference": "KlaviyoFlow-{{ event_id }}",
"amount": "199.00",
"metadata": { "platform": "klaviyo" }
}Header names supported: x-pepf-discount-secret or x-referlabs-discount-secret.
referral_link is mapped as a property (not only a column in the import preview).https://referlabs.com.au/r/AMBCODE) so tracking can attach.Run live diagnostics on the Status page.
referral_link.{{ person.referral_link }}.