Ctrlk
HomepageDocumentationGet FeedOtter
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Klaviyo

This guide covers how to connect Feedotter to Klaviyo and publish newsletter issues through the integration.

Setting Up the Integration

Create a private API key in Klaviyo

Feedotter authenticates with a Klaviyo private API key.

  1. Log in to Klaviyo.

  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.

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.

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:

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).

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:

Last updated