Prerequisites
- You must be a workspace admin.
- You need a Klaviyo account.
Step 1 — Connect Klaviyo
- Open Settings → Integrations
- Select Klaviyo
- Click Connect with Klaviyo
- You will be redirected to Klaviyo to authorize the application
- Once authorized, you’ll see “Klaviyo Connected” in Mailkick
Step 2 — Sync an email
- Open an email in the editor
- Click Export
- Click Sync to Klaviyo
https://www.klaviyo.com/email-editor/{template_id}/edit
How sync works
When you sync an email to Klaviyo:- First sync → Creates a new Template
- Subsequent syncs → Updates the existing template (idempotent via content hash)
- Template deleted on Klaviyo → Mailkick automatically recreates it
Mailkick uses content hashing to avoid unnecessary API calls. If the HTML hasn’t changed, no update is sent.
Using Klaviyo variables
Klaviyo Templates support Django-style variables. In your email, you can use:Common issues
| Error | Cause | Solution |
|---|---|---|
klaviyo_not_configured | Integration not connected | Click “Connect with Klaviyo” in Settings → Integrations |
klaviyo_sync_failed | API error or expired token | Try disconnecting and reconnecting the integration |
klaviyo_http_401 | Token expired | Disconnect and reconnect the integration |
klaviyo_http_403 | Insufficient permissions | Ensure your Klaviyo user has permissions to manage templates |
