HPRS LogoHPRS

Klaviyo Integration

Automatically sync contest entrants to your Klaviyo lists. When someone enters your Promotion, they're subscribed to your list instantly with rich profile properties.

Klaviyo is an industry-leading email and SMS marketing platform known for its powerful segmentation and automation capabilities.

What You'll Need

Before connecting, you'll need your Private API key and a list to sync subscribers to:

1

Private API Key

Log into Klaviyo → Your Account Name (in bottom left) → Account → API Keys → Private API Keys. Click "Create Private API Key", give it a name like "HPRS Integration" and select Custom Key and at least the "List", "Subscriptions" and "Profiles" scopes for Full Access. Click the Create button.

Klaviyo API key creation showing Custom Key option and List/Profiles scopes
2

List

Go to Audience → Lists & Segments → Lists. Create a new list or use an existing one. HPRS will display your lists automatically after validating your API key.

Klaviyo integration panel showing API key input and list selection

Connecting to Your Promotion

Follow these steps to connect Klaviyo to your Promotion:

1

Open your Promotion in the HPRS dashboard

2

Go to the Post Capture tab

3

Click "Klaviyo Connection" to expand the panel

4

Enter your Private API key

5

Select which list to sync subscribers to

6

Click "Connect Klaviyo" to save

Set it and forget it: You only need to connect Klaviyo once per contest. Your connection is securely stored and will automatically sync new entrants to your selected list. If you need to change the list later, simply disconnect and reconnect with the new selection.

Testing Your Integration

To verify your Klaviyo connection is working correctly:

1

Create a test contest with Klaviyo connected to an existing list

2

Enter the contest yourself using a test email address

3

Check your Klaviyo list - the profile should appear within minutes

4

Verify the custom properties (source, contest_id, signup_date) are populated

What Happens When Someone Enters

When a participant submits their email to your Promotion:

  • They're instantly subscribed to your selected Klaviyo list
  • Their name and email are synced as profile properties
  • Custom properties track their source and contest entry date
  • Klaviyo handles the subscription asynchronously (you'll get a 202 response)
  • If they're already subscribed, their profile is updated (no duplicates)

Using Lists Effectively

Klaviyo uses lists to organize subscribers. Profiles can belong to multiple lists:

  • Create a dedicated list for each contest (e.g., "Summer Giveaway 2024")
  • Profiles who enter multiple contests will be in multiple lists
  • Use lists to trigger automated flows when someone joins
  • Combine list membership with profile properties for powerful segments

Double Opt-in

Klaviyo supports double opt-in at the list level. If your list is configured for double opt-in, new subscribers will automatically receive a confirmation email. Configure this in Klaviyo under your list settings.

Custom Properties

HPRS syncs the following data to Klaviyo profiles:

first_name

First name from contest entry

last_name

Last name if provided

source

Marked as "contest" for HPRS entries

signup_date

When they entered the contest (YYYY-MM-DD format)

contest_id

Which contest they entered

Note: Unlike some email platforms, Klaviyo automatically accepts custom properties without needing to pre-define them. Properties will appear on profiles as soon as data is synced.

Tips for Best Results

  • Create a new list for each contest to keep subscribers organized
  • Set up a Flow that triggers when someone is added to your Promotion list
  • After your Promotion ends, create a Campaign targeting just that list
  • Use Klaviyo's Segments to combine list membership with profile properties
  • The "source" property makes it easy to identify all contest-sourced profiles

Troubleshooting

Subscribers not appearing?

Klaviyo processes subscriptions asynchronously. Wait a few minutes and check again. If still missing, verify your API key has the correct scopes.

API key not working?

Make sure you're using a Private API Key, not a Public API Key. The Private API Key starts with "pk_". Ensure it has read/write access to Lists and Profiles.

List not appearing in dropdown?

Verify the list exists in Klaviyo and your API key has access to it. Try generating a new API key with full List access.

Rate limit errors?

Klaviyo has rate limits on API calls. If you're running a high-traffic contest, HPRS handles retries automatically. Contact support if issues persist.

Properties not showing on profiles?

Custom properties are added to the profile, not as separate columns. Click on a profile in Klaviyo to see all properties in the Profile Details section.

Previous

Brevo

Analytics

Next