Klaviyo | YouPurr

This guide will walk you through the process of integrating Klaviyo email marketing with your YouPurr marketplace using webhooks.

Some aspects and visuals of this guide may differ due to the time of documenting.

What you will require

•An active Klaviyo account
•A YouPurr Marketplace account
•Access to your YouPurr Marketplace app

Let's get started!

Step 1: Create a Klaviyo API Key

•
In your Klaviyo Dashboard, go to Settings > API Keys.
•
Create a new API Key called 'YouPurr' and ensure that the 'Events' scope is added with Read and Write permissions.

Klaviyo Create Private API Key page showing YouPurr key configuration with Events scope

•Once the key is created, copy the API key as this will be required to set up the integration in your YouPurr Marketplace app.

Klaviyo Private API Key Confirmation showing the generated key with Read/Write Events access

Important: Your Klaviyo API key must be kept secret. Do not share your API key publicly or with any 3rd parties and ensure it is stored securely.

Step 2: Configure the Webhook in YouPurr

•Login to your YouPurr Marketplace app and go to the settings page by clicking the cog icon in the top right (next to your marketplace logo).

YouPurr Marketplace Dashboard showing navigation and settings

•
Click the 'Webhooks' tab and click the 'Add Webhook' button.
•
A dialog will appear where you can create the new Klaviyo webhook using the following details:

YouPurr Create Webhook dialog showing configuration options

Field	Value
URL	`https://a.klaviyo.com/api/events`
Type	Klaviyo
Events	Select the events you would like to register
Authentication Type	Header
Header Name	Authorization
API Token	`Klaviyo-API-Key` + Your Klaviyo API key value

Payload JSON:

{
  "data": {
    "type": "event",
    "attributes": {
      "properties": {},
      "metric": {
        "data": {
          "type": "metric",
          "attributes": {
            "name": {{eventName}}
          }
        }
      },
      "profile": {
        "data": {
          "type": "profile",
          "attributes": {
            "email": {{email}},
            "phone_number": {{phone}},
            "external_id": {{userId}},
            "first_name": {{firstname}},
            "last_name": {{lastname}},
            "properties": {},
            "meta": {
              "patch_properties": {
                "append": {},
                "unappend": {},
                "unset": ""
              }
            }
          }
        }
      },
      "time": {{dateTimeNow}},
      "unique_id": {{uniqueId}}
    }
  }
}

Note: This payload can be tweaked as per the Klaviyo Events API documentation.

Step 3: Activate and Test

•
Submit the form and create the new webhook. You should now see your newly created Klaviyo webhook within your dashboard webhooks list.
•
Keep an eye on your Klaviyo email flows and see if any events are fired to trigger your email flow.

Congratulations!

You now have some awesome email flows being triggered by YouPurr!

Your marketplace can now automatically trigger Klaviyo email flows based on customer actions such as account creation, order placement, and more.