1. Get the API key
In Klaviyo → Account → Settings → API Keys:
- Public API Key (format
pk_xxx): for client-side, but in DataNostro use the Private API Key (pk_xxxorklp_xxx) — it has more permissions.
2. Fill it in in DataNostro
Dashboard → Platforms → Klaviyo Events — fill in the API key.
3. Test it
Send a test event with customer_email in the payload. In Klaviyo → Profiles → Search, find the profile by email. The server-side event should be recorded in the "Activity feed" section.
What gets mapped
The events purchase, add_to_cart, view_item, sign_up are automatically translated to Klaviyo metric names (Placed Order, Added to Cart, etc.). For custom event names use the $ prefix.