{"version":"1.0","provider_name":"SweepWidget Help Docs","provider_url":"https:\/\/sweepwidget.com\/docs","author_name":"SweepWidget","author_url":"https:\/\/sweepwidget.com\/docs\/author\/sweepwidget","title":"How to Connect Klaviyo to Your Giveaway - SweepWidget Help Docs","type":"rich","width":600,"height":338,"html":"<blockquote class=\"wp-embedded-content\" data-secret=\"ZQx61ISLj2\"><a href=\"https:\/\/sweepwidget.com\/docs\/klaviyo-integration\">How to Connect Klaviyo to Your Giveaway<\/a><\/blockquote><iframe sandbox=\"allow-scripts\" security=\"restricted\" src=\"https:\/\/sweepwidget.com\/docs\/klaviyo-integration\/embed#?secret=ZQx61ISLj2\" width=\"600\" height=\"338\" title=\"&#8220;How to Connect Klaviyo to Your Giveaway&#8221; &#8212; SweepWidget Help Docs\" data-secret=\"ZQx61ISLj2\" frameborder=\"0\" marginwidth=\"0\" marginheight=\"0\" scrolling=\"no\" class=\"wp-embedded-content\"><\/iframe><script>\n\/*! This file is auto-generated *\/\n!function(d,l){\"use strict\";l.querySelector&&d.addEventListener&&\"undefined\"!=typeof URL&&(d.wp=d.wp||{},d.wp.receiveEmbedMessage||(d.wp.receiveEmbedMessage=function(e){var t=e.data;if((t||t.secret||t.message||t.value)&&!\/[^a-zA-Z0-9]\/.test(t.secret)){for(var s,r,n,a=l.querySelectorAll('iframe[data-secret=\"'+t.secret+'\"]'),o=l.querySelectorAll('blockquote[data-secret=\"'+t.secret+'\"]'),c=new RegExp(\"^https?:$\",\"i\"),i=0;i<o.length;i++)o[i].style.display=\"none\";for(i=0;i<a.length;i++)s=a[i],e.source===s.contentWindow&&(s.removeAttribute(\"style\"),\"height\"===t.message?(1e3<(r=parseInt(t.value,10))?r=1e3:~~r<200&&(r=200),s.height=r):\"link\"===t.message&&(r=new URL(s.getAttribute(\"src\")),n=new URL(t.value),c.test(n.protocol))&&n.host===r.host&&l.activeElement===s&&(d.top.location.href=t.value))}},d.addEventListener(\"message\",d.wp.receiveEmbedMessage,!1),l.addEventListener(\"DOMContentLoaded\",function(){for(var e,t,s=l.querySelectorAll(\"iframe.wp-embedded-content\"),r=0;r<s.length;r++)(t=(e=s[r]).getAttribute(\"data-secret\"))||(t=Math.random().toString(36).substring(2,12),e.src+=\"#?secret=\"+t,e.setAttribute(\"data-secret\",t)),e.contentWindow.postMessage({message:\"ready\",secret:t},\"*\")},!1)))}(window,document);\n\/\/# sourceURL=https:\/\/sweepwidget.com\/docs\/wp-includes\/js\/wp-embed.min.js\n<\/script>\n","description":"Klaviyo is a powerful email marketing platform that helps you build customer relationships. With SweepWidget&#8217;s Klaviyo integration, you can automatically add giveaway participants to your Klaviyo lists when they complete the &#8220;Subscribe To Newsletter&#8221; entry method. Table of Contents Overview Requirements Step 1: Get Your Klaviyo Private API Key Step 2: Add the Newsletter Subscription Entry Method Step 3: Connect Klaviyo Step 4: Test Your Integration Troubleshooting Common Issues What Data Gets Sent to Klaviyo Frequently Asked Questions Overview The Klaviyo integration allows you to grow your email list while running giveaways. When a participant completes the &#8220;Subscribe To Newsletter&#8221; entry method, their name and email address are automatically added to your selected Klaviyo list. Plan Required: Pro plan or higher Requirements Before you begin, make sure you have: A Klaviyo account (free or paid) At least one list created and active in Klaviyo (lists must be published, not in draft status) Your Klaviyo private API key (not the public key) with the correct permissions A SweepWidget Pro plan or higher Important: API Key Permissions Required Your Klaviyo private API key must have both of these permissions for the integration to work: Permission Access Level Why It&#8217;s Needed Lists Read To fetch and display your available lists in SweepWidget Profiles Full Access (Read\/Write) To create new subscriber profiles and add them to your lists If either permission is missing, the integration will fail. Lists won&#8217;t load without &#8220;Lists &#8211; Read&#8221; permission, and subscribers won&#8217;t be added without &#8220;Profiles &#8211; Full Access&#8221; permission. Step 1: Get Your Klaviyo Private API Key Important: You must use your private API key, not the public key. The public key will not work for this integration. To find your Klaviyo private API key: Log in to your Klaviyo account Click on your account name in the lower-left corner Select Settings Click on API Keys in the left sidebar Under &#8220;Private API Keys&#8221;, you&#8217;ll see your existing keys or can create a new one Click Create Private API Key if you need a new one Give it a name like &#8220;SweepWidget Integration&#8221; Set the required scopes\/permissions: Lists &#8211; Select Read access Profiles &#8211; Select Full Access (both Read and Write) Click Create to generate the key Copy the API key immediately (it starts with &#8220;pk_&#8221; for private keys) Note: Private keys start with pk_ while public keys start with a different prefix. Make sure you&#8217;re using the private key. For detailed instructions, see Klaviyo&#8217;s guide on managing API keys. Before You Continue: Create a List in Klaviyo Before connecting to SweepWidget, make sure you have at least one active\/published list in your Klaviyo account: In Klaviyo, go to Audience \u2192 Lists &amp; Segments Click Create List \/ Segment Select List Give your list a name (e.g., &#8220;Giveaway Subscribers&#8221;) Click Create Important: The list must be active\/published. Draft lists or suppression lists will not appear when you fetch lists in SweepWidget. Step 2: Add the Newsletter Subscription Entry Method In your SweepWidget giveaway editor, go to the Entry Methods tab Click the + Add Entry Method button From the entry method selection popup, click Newsletter Subscription (it has an envelope icon) After adding the entry method, you&#8217;ll see the configuration panel: Configure the basic settings: Entry Label: The text participants will see (default: &#8220;Subscribe To Newsletter&#8221;) Worth # entries: How many entries this action is worth Newsletter Name: A display name for your newsletter (e.g., &#8220;My Newsletter&#8221;) Mandatory: Check this to require participants to subscribe to enter Step 3: Connect Klaviyo Now connect your Klaviyo account: Check the box Integrate Your Email List A grid of email marketing providers will appear Click on the Klaviyo icon After selecting Klaviyo, you&#8217;ll see the API configuration section: In the &#8220;Enter your Klaviyo private API key&#8221; field, paste your private API key Click the Fetch Lists button Wait for your lists to load (this may take a few seconds) Select the list you want subscribers added to from the Newsletter Lists dropdown Click Save &amp; Publish to save your giveaway If no lists appear: Make sure your API key has &#8220;Lists &#8211; Read&#8221; permission and that you have at least one active list in Klaviyo (not a draft or suppression list). Step 4: Test Your Integration Before launching your giveaway, test the integration: Preview your giveaway or visit the live giveaway URL Enter the giveaway with a test email address Complete the &#8220;Subscribe To Newsletter&#8221; entry method Go to your Klaviyo account and check your list Verify the test email was added to the list Tip: Use a different email than your Klaviyo account email for testing, as some platforms filter out their own account emails. Troubleshooting Common Issues Lists Not Loading \/ &#8220;No lists found&#8221; If clicking &#8220;Fetch Lists&#8221; doesn&#8217;t show your lists: Wrong API key type: Make sure you&#8217;re using your private API key (starts with pk_), not the public key Missing API permission: Your API key needs &#8220;Lists &#8211; Read&#8221; permission. Create a new key with this permission if missing No active lists exist: Create at least one active\/published list in Klaviyo before trying to fetch. Draft lists and suppression lists won&#8217;t appear API key inactive: Check in Klaviyo that the API key is active and not revoked Copy\/paste error: Re-copy the API key directly from Klaviyo, ensuring no extra spaces Subscribers Not Being Added to List If participants complete the entry but don&#8217;t appear in your Klaviyo list: Missing API permission: Your API key needs &#8220;Profiles &#8211; Full Access&#8221; (Read and Write) permission to create profiles and add them to lists. This is the most common issue! Profile already exists: If the email already exists in Klaviyo, they&#8217;ll be added to the list (not duplicated). Check if they&#8217;re already a member List changed: If you renamed or deleted the list in Klaviyo after setting up the giveaway, you need to re-fetch lists and re-select Check suppressed profiles: In Klaviyo, check if the email is in your suppressed list &#8220;Error&#8221; When Fetching Lists If you see","thumbnail_url":"https:\/\/sweepwidget.com\/docs\/wp-content\/uploads\/2026\/01\/klaviyo-1.png","thumbnail_width":1500,"thumbnail_height":784}