Connecting Klaviyo to Sonar Seed

Sync your ambassador data to Klaviyo to build custom email flows, track engagement, and maintain your brand's voice.

1. Get your Klaviyo API Key

1. Log in to your Klaviyo Account.
2. Go to Settings > API Keys.
3. Create a new Private API Key with the following access levels:
   • Events: Full Access (to track custom events)
   • List: Full Access (to add new ambassadors to your list)
   • Metrics: Full Access (to verify integration)
   • Profiles: Full Access (to create and update profiles)
   • Subscriptions: Full Access (to subscribe profiles to lists)
4. Copy the key (starts with pk_).

2. Connect in Sonar Seed

1. In Sonar Seed, go to Settings > Integrations.
2. Paste your Private API Key into the Klaviyo Private API Key field.
3. Click Save Klaviyo Settings.
   • Sonar will automatically create necessary metrics in your account if they don't exist.

3. Select your Ambassador List

Once connected, select the Klaviyo List where you want newly approved ambassadors to be added.

Klaviyo Metrics & Event Data

When an event happens in Sonar Seed, we send a Metric (the event name) along with Event Properties (the data).

Common Properties

These properties are included in every event sent to Klaviyo:

• {{ event.FirstName }} & {{ event.LastName }}: Ambassador's name.
• {{ event.Email }}: Ambassador's primary email.
• {{ event.BrandName }}: Your brand's name.
• {{ event.PortalUrl }}: The base URL for the Ambassador Portal.
• {{ event.LogoUrl }}: Your brand logo URL.
• {{ event.PrimaryColor }} & {{ event.SecondaryColor }}: Your brand's hex colors.
• {{ event.SupportEmail }} & {{ event.SupportUrl }}: Your contact information.
• {{ event.CompanyAddress }}: Your mailing address for compliance.

Event Specific Properties

Each metric includes additional data relevant to that specific trigger:

Profile Properties

In addition to events, Sonar Seed also updates the Profile of the ambassador.

• Sonar Status: Updated to "Invited", "Active", or "Rejected".
• Sonar Tier: The current tier of the ambassador (e.g., MEMBER, VIP, ELITE).
• FirstName / LastName: Synced from their application.
• Email: Primary contact email.

Is data sent with metrics?

Yes. Every metric includes a payload of properties. For example, when "Sonar Seed: Gift Shipped" fires, it doesn't just tell Klaviyo that something was shipped; it includes the TrackingUrl and OrderNumber so you can include those details directly in your Klaviyo email.

How to use properties in Klaviyo

1. In your Klaviyo email editor, add a text block.
2. Use the syntax {{ event.PropertyName|default:'' }}.
3. Example: Hi {{ event.FirstName }}, your gift is on its way!
4. For the Broadcast content specifically, use {{ event.ContentHtml|safe }} to ensure the HTML renders correctly.

5. Switching Over

By default, Sonar Seed continues to send its built-in emails even after connecting Klaviyo. This allows you to test your flows.

Once your Klaviyo Flows are ready:

1. Go to Settings > Integrations > Klaviyo.
2. Change Email Handling to "Use Klaviyo Flows Only".
3. Click Save.

Sonar Seed will now stop sending programmatic emails and rely entirely on your Klaviyo Flows.