Rivalry2

HTML Diff

17 added 18 removed

Original 2026-01-01

Modified 2026-03-10

1 Solution Recipes are tutorials to achieve specific objectives in Klaviyo. They can also help you master Klaviyo, learn new third-party technologies, and come up with creative ideas. They are written mainly for developers and technically-advanced users.

2 - Note:We do our best to make sure any code and API references are accurate and current when this is published, but you might need to update code and it’s always a best practice to leverage our<a>latest API versions</a>. If you have questions, feel free to hop over to our<a>Developer Community</a>.

2 + Note:We do our best to make sure any code and API references are accurate and current when this is published, but you might need to update code and it’s always a best practice to leverage our<a>latest API versions</a>. If you have questions, feel free to hop over to our<a>Developer Community</a>.

3 What you’ll learn

4 Integrate with a third-party API such as OpenAI to generate dynamic content and import it into your Klaviyo account, to use in campaigns and messages.

5 Level of sophistication

6 Moderate

7 <h2>Introduction</h2>

8 - This solution recipe will show you how to create awesome AI-generated images for your next Klaviyo campaign.

8 + This solution recipe will show you how to create awesome AI-generated images for your next Klaviyo campaign.

9 In this case, we’re a brand that sells avocados and avocado accessories, and we’re looking to create the perfect illustration for a big sale campaign.

10 <h2>Challenge</h2>

11 Give AI a prompt for creating the perfect image for my brand’s upcoming email campaign campaign, get that into my Klaviyo Images & Brand library, and create an email campaign using the asset.

12 Klaviyo recently released<a>APIs</a>for uploading images to your account, so this is now possible!

13 Note that you should check any AI-created images for brand compliance and adhere to any copyright or monetization concerns. Before you begin, we recommend consulting your legal team before using any AI service to ensure you’re in compliance with your company’s policies. It is also your responsibility to ensure that your usage of any images that OpenAI generates and which you use in Klaviyo campaigns meets the<a>OpenAI usage policy</a>.

14 <h2>Preparation</h2>

15 - <h3>Get started with Klaviyo’s APIs </h3>

15 + <h3>Get started with Klaviyo’s APIs</h3>

16 - <ol><li><a>Create a test account</a>if you don’t have one already for experimentation purposes. </li>

16 + <ol><li><a>Create a test account</a>if you don’t have one already for experimentation purposes.</li>

17 - <li>Fork our latest Postman Collection from the<a>Klaviyo Developers workspace</a>, or<a>fork the 2023-10-15 collection directly</a>. </li>

17 + <li>Fork our latest Postman Collection from the<a>Klaviyo Developers workspace</a>, or<a>fork the 2023-10-15 collection directly</a>.</li>

18 <li>Create and retrieve<a>your private API key</a>.</li>

19 </ol><h3>Get started with OpenAI’s Dall-E API</h3>

20 - <ol><li><a>Create an OpenAI account</a>if you don’t already have one! </li>

20 + <ol><li><a>Create an OpenAI account</a>if you don’t already have one!</li>

21 <li>They have a<a>great API overview</a>and a<a>quickstart Python SDK guide</a>.</li>

22 - <li>Create and retrieve<a>your OpenAI API key</a>. </li>

22 + <li>Create and retrieve<a>your OpenAI API key</a>.</li>

23 - <li>Read OpenAI’s<a>terms and policies</a>. </li>

23 + <li>Read OpenAI’s<a>terms and policies</a>.</li>

24 <li>To learn more about how OpenAI prices their Dall-E APIs, see their<a>pricing page</a>.</li>

25 </ol><h3>Get started with Napkin.io</h3>

26 If you don’t have one already, sign up for a free<a>Napkin.io</a>account. Napkin is a Klaviyo tool that allows you to write and run server-less functions. You can also use the code-hosting platform of your choice to run the code you will write in this recipe.

27 <h2>Using Dall-E APIs to generate images from a prompt</h2>

28 In the following example Postman request, a call is made to OpenAPI’s<a>Create image endpoint</a>:

29 - Here’s the same request using the OpenAI Python SDK:

29 + Here’s the same request using the OpenAI Python SDK:

30 import os import openai def openai_generate_images(request): openai.api_key = os.getenv("OPENAI_API_KEY") input = request.body or {} openai_response = openai.Image.create( prompt=input.get("prompt") or "an avocado, in kawaii art style", n=input.get("count") or 1, size=input.get("size") or "1024x1024" ) return openai_responseNote that if you set n to a value greater than 1, you will get an image URL for each variant in the data array.

31 Calling the OpenAI API will return a response like the following. Note that the URLs returned by this API expire after an hour, so you’ll want to upload it to Klaviyo before this expiration.

32 - { "created": 1698068491, "data": [ { "url": "https://oaidalleapiprodscus.blob.core.windows.net/private/org-aEQ28uSWRwi3n5i3LjFnBc10/user-yDW3f5wi900b8BH1XHKzdt6v/img-CeSj5ECGNfBafd0RrKKGVkpR.png?st=2023-11-30T00%3A40%3A29Z&se=2023-11-30T02%3A40%3A29Z&sp=r&sv=2021-08-06&sr=b&rscd=inline&rsct=image/png&skoid=6aaadede-4fb3-4698-a8f6-684d7786b067&sktid=a48cca56-e6da-484e-a814-9c849652bcb3&skt=2023-11-29T19%3A10%3A01Z&ske=2023-11-30T19%3A10%3A01Z&sks=b&skv=2021-08-06&sig=vX%2BemIRMP/57eI/HAPVEjMMPnJ5FKfetCqeEKlfIC/Y%3D" } ] }<h2>Using Klaviyo’s APIs to upload images </h2>

32 + { "created": 1698068491, "data": [ { "url": "https://oaidalleapiprodscus.blob.core.windows.net/private/org-aEQ28uSWRwi3n5i3LjFnBc10/user-yDW3f5wi900b8BH1XHKzdt6v/img-CeSj5ECGNfBafd0RrKKGVkpR.png?st=2023-11-30T00%3A40%3A29Z&se=2023-11-30T02%3A40%3A29Z&sp=r&sv=2021-08-06&sr=b&rscd=inline&rsct=image/png&skoid=6aaadede-4fb3-4698-a8f6-684d7786b067&sktid=a48cca56-e6da-484e-a814-9c849652bcb3&skt=2023-11-29T19%3A10%3A01Z&ske=2023-11-30T19%3A10%3A01Z&sks=b&skv=2021-08-06&sig=vX%2BemIRMP/57eI/HAPVEjMMPnJ5FKfetCqeEKlfIC/Y%3D" } ] }Once you have created an image URL from OpenAI’s Dall-E API, you can upload that as an image asset to your Klaviyo account. Here’s what that looks like:

33 - Once you have created an image URL from OpenAI’s Dall-E API, you can upload that as an image asset to your Klaviyo account. Here’s what that looks like:

34 Here is an example Python function using<a>Klaviyo’s Python SDK</a>:

33 Here is an example Python function using<a>Klaviyo’s Python SDK</a>:

35 import os from klaviyo_api import KlaviyoAPI def klaviyo_create_image(image_src, image_name): klaviyo = KlaviyoAPI(os.getenv("KLAVIYO_API_KEY"), max_delay=60, max_retries=3, test_host=None) klaviyo_response = klaviyo.Images.upload_image_from_url({ "data": { "type": "image", "attributes": { "import_from_url": image_url, "name": image_name, "hidden": False } } }) return klaviyo_response<h2>Putting the Dall-E and Klaviyo APIs together</h2>

34 import os from klaviyo_api import KlaviyoAPI def klaviyo_create_image(image_src, image_name): klaviyo = KlaviyoAPI(os.getenv("KLAVIYO_API_KEY"), max_delay=60, max_retries=3, test_host=None) klaviyo_response = klaviyo.Images.upload_image_from_url({ "data": { "type": "image", "attributes": { "import_from_url": image_url, "name": image_name, "hidden": False } } }) return klaviyo_response<h2>Putting the Dall-E and Klaviyo APIs together</h2>

36 - Here’s a<a>Napkin function</a>that uses Dall-E and Klaviyo APIs together. ClickAdd to your Functionsto clone the function to your account.

35 + Here’s a<a>Napkin function</a>that uses Dall-E and Klaviyo APIs together. ClickAdd to your Functionsto clone the function to your account.

37 When you clone the function, you should see the code appear in your Napkin account, and any necessary dependencies will also be installed.

36 When you clone the function, you should see the code appear in your Napkin account, and any necessary dependencies will also be installed.

38 - We now need to configure some environment variables. These details are required so that the function knows which OpenAI account to use for generating images and which Klaviyo account to send the images to.

37 + We now need to configure some environment variables. These details are required so that the function knows which OpenAI account to use for generating images and which Klaviyo account to send the images to.

39 To add them, navigate to theOthertab. Next scroll down toEnvironment Variables.

38 To add them, navigate to theOthertab. Next scroll down toEnvironment Variables.

40 - You will need to add the following variables in order to use the Napkin function:

39 + You will need to add the following variables in order to use the Napkin function:

41 - <ol><li>KLAVIYO_API_KEY: This is the<a>Private API Key for your Klaviyo account</a>. </li>

40 + <ol><li>KLAVIYO_API_KEY: This is the<a>Private API Key for your Klaviyo account</a>.</li>

42 - <li>OPENAI_API_KEY: This is the<a>API key for your OpenAI account</a>. </li>

41 + <li>OPENAI_API_KEY: This is the<a>API key for your OpenAI account</a>.</li>

43 - </ol>Then, you can run the function using the default variables included in the function. Or, you can make a POST request to the Napkin URL with a payload like the one below, replacing the prompt, size, and number of variants as you wish.

42 + </ol>Then, you can run the function using the default variables included in the function. Or, you can make a POST request to the Napkin URL with a payload like the one below, replacing the prompt, size, and number of variants as you wish.

44 { "prompt": "an avocado, in kawaii art style", "count": 1, "size": "1024x1024", "name": "cute avocado photo" }<h2>Building your campaign with your AI-generated image</h2>

43 { "prompt": "an avocado, in kawaii art style", "count": 1, "size": "1024x1024", "name": "cute avocado photo" }<h2>Building your campaign with your AI-generated image</h2>

45 - Now that you’ve created an image for your cute avocado image using AI, it’s time to actually use it in a campaign. Create a campaign within your Klaviyo account, add an SMS message (or email), and drop in your avocado image (or whatever image) ready to go.

44 + Now that you’ve created an image for your cute avocado image using AI, it’s time to actually use it in a campaign. Create a campaign within your Klaviyo account, add an SMS message (or email), and drop in your avocado image (or whatever image) ready to go.

46 Navigate toCampaigns, clickCreate Campaign,and provide campaign details like theAvocado Email Campaignbelow:

45 Navigate toCampaigns, clickCreate Campaign,and provide campaign details like theAvocado Email Campaignbelow:

47 Choose a template.

46 Choose a template.

48 Add your image!

47 Add your image!

49 Profit!

48 Profit!