Connect mani to Klaviyo
Before you start
- ☐ A Klaviyo account with at least 1 list
- ☐ A mani account (Free plan or above)
- ☐ Klaviyo API key (found in Account > Settings > API Keys)
Setup steps
Get your Klaviyo API key
In Klaviyo, go to Account > Settings > API Keys. Copy your Private API Key.
What good looks like
A string starting with 'pk_' copied to clipboard.
Common errors
Use the Private key, not the Public key. The Public key starts with 'Qx' and does not have write access.
Open mani Integrations
In mani, go to Settings > Integrations > Klaviyo.
What good looks like
You see a Klaviyo card with a 'Connect' button.
Common errors
If not visible, ensure you are on Starter plan or above.
Paste your API key
Click Connect, paste your Klaviyo Private API Key, and click Save.
What good looks like
Status changes to 'Connected' with your Klaviyo account name displayed.
Common errors
If connection fails, verify the API key is correct and has full access permissions.
Select your target list
Choose which Klaviyo list receives mani-generated email creative. Typically your main newsletter list.
What good looks like
A dropdown shows your Klaviyo lists. Select one.
Common errors
If no lists appear, create at least one list in Klaviyo first.
Generate email creative
In mani, generate an ad with 'email' type selected. Choose subject line + body + hero image.
What good looks like
An email creative with your brand colors, tone, and products appears.
Common errors
If output looks generic, check that your Brand DNA has been extracted.
Export to Klaviyo
Approve the email creative and click Export > Klaviyo.
What good looks like
The creative appears in your Klaviyo template library.
Common errors
If export fails, check that your API key has write access to templates.
Enable webhook events
In Settings > Integrations > Klaviyo > Webhooks, enable 'New subscriber' and 'Segment entered.'
What good looks like
Webhook events show as 'Active' with green indicators.
Common errors
Webhooks require Pro plan or above. Upgrade if not visible.
Test the flow
Add a test subscriber to your Klaviyo list. Verify that mani generates a welcome email creative within 5 minutes.
What good looks like
A new email creative appears in your mani queue tagged 'Klaviyo trigger.'
Common errors
If no creative appears, check webhook status in Settings > Integrations > Klaviyo.
What you can do once connected
Troubleshooting
API key rejected
Use the Private API Key (starts with 'pk_'), not the Public key. Regenerate if expired.
Lists not appearing
Create at least one list in Klaviyo. Mani queries lists via the API on connection.
Webhooks not firing
Check Klaviyo > Account > Webhooks for delivery failures. Ensure mani's webhook URL is whitelisted.
Email creative looks different in Klaviyo
Mani exports HTML. Klaviyo may apply its own CSS. Preview in Klaviyo before sending.
Subscriber count mismatch
Mani syncs subscriber count every 24 hours. Recent changes may not be reflected immediately.
Disconnect
Go to Settings > Integrations > Klaviyo > Disconnect. Webhooks stop immediately. API key is deleted from mani. Your Klaviyo account is not affected.
Questions
Which Klaviyo plan do I need?+
Any paid Klaviyo plan with API access. Free Klaviyo plans have limited API capabilities.
Does mani send emails through Klaviyo?+
No. Mani generates the creative (subject line, body, images). You send through Klaviyo as usual.
Can I use mani for SMS creative?+
Yes. Generate SMS copy from your Brand DNA. Export as text for use in Klaviyo SMS flows.
How does the webhook integration work?+
Klaviyo sends events (new subscriber, segment entered) to mani via webhook. Mani auto-generates creative in response.
Can I disconnect without losing data?+
Yes. Disconnecting stops the sync and webhooks. Your generated creative remains in mani.
Is my Klaviyo data safe?+
Mani accesses list names and subscriber counts only. We do not read individual subscriber emails or personal data.
Can I connect multiple Klaviyo accounts?+
One Klaviyo account per mani brand. If you manage multiple brands, each brand connects to its own Klaviyo account.
What about Klaviyo flows?+
Mani generates the creative assets. You build the flow logic in Klaviyo. Mani does not modify your flow structure.