> For the complete documentation index, see [llms.txt](https://the-wishlist-documentation.gitbook.io/the-wishlist-documentation-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://the-wishlist-documentation.gitbook.io/the-wishlist-documentation-docs/integrations/yotpo.md).

# Yotpo

This guide walks you through connecting The Wishlist platform with Yotpo to enable automated email and SMS marketing campaigns based on customer wishlist activity.

## Part 1: Connecting The Wishlist to Yotpo

### Step 1: Access Yotpo Account Settings

1. Login to Yotpo as an admin
2. Click the **Account** button in the top right corner
3. Select **Account Settings** from the dropdown menu

### Step 2: Get Your API keys

1. Click **Get secret key**
2. Check your email for the verification code
3. Enter the code in the field and click **Submit**
4. Copy both the **Secret Key** and **App Key** (you'll need to enter these in The Wishlist Store Console)

### Step 3: Configure The Wishlist Integration

1. In the Wishlist Store Console admin panel, navigate to **Integrations > Marketing Tools**
2. Select **Yotpo** and click **Activate**
3. Click **Configure**
4. Enter your **App Key** and **Secret Key**
5. Click **Save**

### Step 4: Enable Notifications

1. Select the notification types you want to use
2. Set your preferred thresholds for each notification type
3. Save your settings

## Part 2: Setting Up Yotpo Flows

### Step 5: Access SMS & Email Module

1. In Yotpo, ensure you're in the **SMS & Email** module
2. If not, click the module selector in the top right and choose **SMS & Email**

### Step 6: Enable Custom Triggers

1. Navigate to **Flows > Custom Triggers**
2. Toggle each Wishlist trigger from **Hidden** to **Displayed**
3. Ensure **Marketing** is selected under trigger type

**Note**: This ensures messages only go to customers who have opted in to marketing communications

### Step 7: Create Your Flow

1. Go to **Flows > My Flows**
2. Click **Create Flow** in the top right
3. In the trigger search field, type **twc**
4. Select your desired Wishlist trigger from the results
5. Define your flow conditions and steps

### Step 8: Add Your Action

1. Click **Add action**
2. Choose **Email message** or **SMS/MMS message** (you could also have both as part of you flow journey).

## Part 3: Configuring Messages

### For SMS/MMS Messages

1. Write your message copy
2. Click the **{--}** button to add dynamic content
3. Scroll to **Custom event properties**
4. Click **+ Select property**
5. Choose the wishlist elements to include in your message

### For Email Messages

1. Enter a subject line
2. Click **Edit design** (scroll down to find this button)

### Setting Up Dynamic Product Display

From the **Blocks** section, drag the **Dynamic Table** block into your email

Configure the table layout:

* Choose which column displays the product image
* Choose which column displays product details

Configure Product Images:

1. Click the image column
2. Select **Product image URL** to display the product image
3. Select **Product variant URL** to make the image clickable (links it to the product page)

Add Product Details:

1. Click the details column
2. Use "Add property" to include:

* Product name
* Size
* Color
* Price
* Other relevant properties

3. Adjust text positioning using the formatting settings
4. Use the toolbar to modify fonts and styling

Set Display Limits:

1. Click the table border to select the entire table
2. Set the maximum number of products to display per email

**Note**: If fewer items exist than your maximum, the email layout adjusts automatically without leaving empty space

## Best Practices

* Test your flows before going live
* Keep messages concise and focused on value
* Use clear calls-to-action to drive conversions
* Monitor performance and adjust thresholds as needed
* Ensure mobile optimization for all email templates

## Troubleshooting

Common Issues:

* API keys not working: Double-check that you copied the full key without extra spaces
* Triggers not appearing: Ensure they're set to "Displayed" and trigger type is "Marketing"
* Images not loading: Verify the product image URL is correctly configured
* Flow not triggering: Check that conditions are properly set and customers are opted in

**Need Help?** Contact The Wishlist support team at <support@thewishlist.io> or Yotpo support for platform-specific issues.