Klaviyo — Events API setup

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_xxx or klp_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.