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

# Klaviyo

#### Setting Up the Integration

**Create a private API key in Klaviyo**

Feedotter authenticates with a **Klaviyo private API key**.

1. Log in to [Klaviyo](https://www.klaviyo.com/).
2. Open **Settings → API keys**.
3. Click **Create Private API Key**.
4. Give the key a descriptive name (for example, `Feedotter`).
5. Grant the key access to create and send campaigns. At minimum, the key needs permission to:
   * Read lists and segments
   * Read and write templates
   * Read and write campaigns
   * Read and write tags (only required if you attach tags when publishing)
6. Copy the key and store it somewhere safe. Klaviyo will not show the full key again.

<figure><img src="/files/u8JAmh4JAN1ftbZYbEL8" alt=""><figcaption></figcaption></figure>

**Add the connection in Feedotter**

Navigate to your integrations settings and add a new Klaviyo connection with the following fields:

**Connection Label** — A memorable name for this connection (e.g., "Klaviyo" or something more specific if you manage multiple accounts).

**API Key** — The private API key you created in Klaviyo.

<figure><img src="/files/WM1rQlWK9x402STH8Hc9" alt=""><figcaption></figcaption></figure>

Feedotter verifies the key on save. Once connected, the integration appears in your connections list and is available when you publish an issue.

> **Tip:** Before publishing to a live audience, we strongly recommend using a small test list or segment in Klaviyo. Use that audience for initial testing to verify your setup and content before sending to your full list.

***

#### Publishing a Newsletter Issue

When you're ready to publish an issue, Feedotter will walk you through the following configuration:

<figure><img src="/files/IyElm4JbbmvcseSczP0Y" alt=""><figcaption></figcaption></figure>

**Issue Details**

Confirm the issue name and the Klaviyo connection you're publishing to.

Sender details (from name, from email, reply-to, subject, and preview text) come from the issue / newsletter settings in Feedotter. Those values are written onto the Klaviyo campaign when you publish.

**Publishing Action**

Choose one of two options:

* **Create a new campaign and schedule a send** *(default)* — Creates the campaign in Klaviyo and either sends immediately or schedules the send for the date and time you choose.
* **Create a new campaign only** — Creates the campaign in Klaviyo as a draft. You finish reviewing and sending in Klaviyo.

**Klaviyo Details**

| Field           | Notes                                                                                                                                                          |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Audience**    | Required. Choose one or more **lists** and/or **segments**. You can mix both in a single send.                                                                 |
| **Suppression** | Optional. Lists or segments to exclude from the send. A list or segment **cannot** appear in both Audience and Suppression — Klaviyo will reject the campaign. |
| **Tags**        | Optional. Existing Klaviyo tags to attach to the campaign for organization in Klaviyo.                                                                         |

**Schedule Your Send**

This section appears when **Create a new campaign and schedule a send** is selected.

Choose **Send Now** to send immediately, or **Schedule** to set a future date, time, and timezone.

Scheduled sends must be at least **15 minutes** in the future (in the timezone you select).

<figure><img src="/files/z3uUcZOlcvzyKEv1FZWC" alt=""><figcaption></figcaption></figure>

***

#### Important Considerations

**Unsubscribe tags are required**

Klaviyo requires an unsubscribe tag in **both** the HTML and the plain-text version of the email. Feedotter will block publish if either is missing.

Use one of these tags:

* `{% unsubscribe %}`
* `{% unsubscribe_link %}`

A typical HTML footer looks like:

```html
<a href="<div data-gb-custom-block data-tag="unsubscribe_link"></div>">Unsubscribe</a>
```