What you need
- A Denada project with an email ready to push
- A Klaviyo account where you can create a private API key
Create a Klaviyo private API key
- Log in to your Klaviyo account.
- Click Settings on the account name in the lower left.
- Under Private API Keys, click Create PRIVATE API Key.
- Give the key a name like “Denada integration”.
- Grant it Full Access to at least Templates and Images (Templates is required; Images is only needed if you want Denada to upload images to Klaviyo).
- Click Save and copy the key.
Connect Denada to Klaviyo
1
Open the Integrations dialog
Click Share on any project, then under Integrations, click Configure. (You can also open your team’s Settings page and click Add integration in the Integrations panel — manager access required.)
2
Select Klaviyo
Choose Klaviyo from the list of platforms.
3
Enter your credentials
- Name — optional, e.g. “Production”.
- Private API key — the key you created above.
4
Validate and save
Click Validate to confirm the key works, then click Save.
Push an email to Klaviyo
- Open the project and click Share.
- Under Integrations, select Export to Klaviyo.
- Fill in the export dialog:
- Template name — the name that will appear in Klaviyo. Defaults to your project’s name.
- Upload images - Klaviyo hosts images — optional. When checked, Denada uploads your email’s images to Klaviyo and rewrites the HTML to use Klaviyo-hosted URLs. When unchecked, images stay hosted on Denada’s CDN.
- Click Export.
How updates work
- Re-exporting updates in place. If you’ve pushed this project to Klaviyo before, the export dialog shows a Previous export option: choose Update existing to update the same Klaviyo template, or Create new to make a separate one. If the previous one was deleted in Klaviyo, Denada creates a new one automatically.
- Previously uploaded images are reused. When re-exporting with image upload enabled, the Previously uploaded images option lets you reuse the existing Klaviyo-hosted copies (Use existing uploads) or upload fresh ones (Upload new). Reusing is the default.
Klaviyo allows multiple templates with the same name, so there is no overwrite confirmation like some other platforms — use the Previous export option to control whether you update or duplicate.
Troubleshooting
'Invalid API key' error during validation
'Invalid API key' error during validation
Make sure you’re using a private API key (they start with
pk_), not a public key, and that it hasn’t been revoked in Klaviyo.Image upload fails but the export succeeds
Image upload fails but the export succeeds
Check that the API key has access to Images in addition to Templates. Without it, Denada can’t create image assets in Klaviyo.