Klaviyo connector

Connect Klaviyo to keep a client mind current with sent email and SMS campaigns.

What it imports

• Email subject lines and readable template content. HTML, scripts, styles, and tracking markup are removed.
• SMS message bodies.
• One aggregate performance snapshot per campaign with recipients, opens, clicks, conversions, conversion rate, and revenue.

Armbrain never imports Klaviyo profiles or per-recipient activity. Each campaign creates exactly two memories: one for campaign content and one synthesized results snapshot.

Before you connect

Create a Klaviyo private API key with these read-only scopes:

• accounts:read
• campaigns:read
• templates:read
• metrics:read

The connected account must expose a Placed Order metric. Klaviyo requires a conversion metric ID when requesting campaign reports, and Armbrain uses that metric for conversions and revenue. If setup cannot find it, confirm your ecommerce integration is sending Placed Order events.

Connect

1. Open Settings → Connectors in Armbrain HQ.
2. Choose Klaviyo.
3. Select the client mind that should receive the campaigns.
4. Paste the private API key and select Continue.

The API key is encrypted before storage. Armbrain validates it against the Klaviyo account and stores only account and conversion-metric identifiers as connector settings.

Sync behavior

• The first sync looks back 30 days.
• Later syncs request only sent campaigns since the last successful poll.
• Email and SMS are queried separately because Klaviyo requires a channel filter.
• Polling runs every 30 minutes.
• Klaviyo campaign reporting is rate-limited. Armbrain stages successful report responses so a downstream retry does not request the same report again.

Troubleshooting

• API key rejected: Confirm the key is active and has all four read scopes listed above.
• Placed Order metric missing: Confirm the store integration is connected in Klaviyo and has produced at least one Placed Order event.
• Campaign not imported: Only campaigns with status Sent are imported. Drafts, scheduled campaigns, and per-recipient events are ignored.
• Revision error: The connector pins Klaviyo API revision 2026-07-15. A revision retirement is reported explicitly so the connector can be upgraded rather than repeatedly retried.