FAQ

Where do I find my Klaviyo API key?

In Klaviyo, go to Settings → API Keys. Click Create Private API Key, give it a name, and set the appropriate read permissions for the data you want to export (e.g., Campaigns, Profiles, Metrics). Copy the key and paste it into Coupler.io when prompted. Do not use your Public API key — it won't work for data exports.

What's the difference between Campaigns list and Report?

The Campaigns list entity returns metadata about your campaigns — name, channel, status, send time, target lists — but no performance numbers. The Report entity returns performance metrics (opens, clicks, revenue, etc.) that you configure yourself by selecting metrics and dimensions. Use Campaigns list to audit your campaign setup, and Report to measure results.

Why is my revenue or "Placed Orders" column empty?

Revenue and order data in Klaviyo only appears when the Placed Order event is actively tracked in your account and attributed to a message. Check that your Klaviyo integration with your store (e.g., Shopify) is enabled and that the Placed Order metric exists under Analytics → Metrics. If the metric isn't there, the column will always be empty.

I'm getting a "404 metric with ID does not exist" error. What do I do?

This means a metric selected in your Report configuration has been deleted or is no longer available in your Klaviyo account. Open your data flow, go to the source settings, remove all metrics, and re-select them from the current list. This usually happens after changes are made directly in Klaviyo.

Can I pull data from multiple Klaviyo accounts into one report?

Yes. Create a separate data flow for each Klaviyo account, each with its own API key. Then use Coupler.io's Append transformation to merge all the data into a single destination sheet or table. This is the recommended approach for agencies managing multiple brands.

My Profiles export keeps timing out. How do I fix it?

Large subscriber lists often time out during export. Use the Advanced filters option in the Profiles list entity to narrow your export to a specific segment, list, or status. Exporting a filtered subset is much faster than pulling your entire contact database in one run.

Can I export more than one year of Report data?

Not in a single data flow — the Klaviyo API enforces a one-year maximum on Report requests. To get multi-year data, create one data flow per year, each with its own date range, and use the Append transformation to combine them into a single table.

Why do my exported dates look different from what I see in Klaviyo's dashboard?

Klaviyo's API returns timestamps in UTC. If your Klaviyo dashboard is set to a different timezone, the dates may appear shifted when exported. Use the date picker to account for the UTC offset when setting your date range, and verify timestamps in the exported destination rather than the preview.

Can I use Klaviyo data with AI tools?

Yes. Coupler.io supports AI destinations including ChatGPT, Claude, Gemini, Cursor, Perplexity, and OpenClaw. You can send your Klaviyo Report data directly to these tools for automated analysis, recommendations, or content generation based on your email performance.

For a full breakdown of available metrics and dimensions, see Data Overview. For help with timeouts, 404 errors, and date discrepancies, see Common Issues. For tips on filtering profiles and combining multi-account data, see Best Practices.