FAQ

Where do I find my Amplitude API key and Secret key?

In Amplitude, go to Settings → Projects, select your project, and open the General tab. You'll see both the API key and Secret key listed there. Note that these are project-level credentials — each project has its own unique pair.

Can I pull data from multiple Amplitude projects into one destination?

Yes. Add multiple sources to the same data flow — one per Amplitude project, each with its own API credentials. Use the Append transformation to combine the data into a single table. This is useful if you have separate Amplitude projects for iOS and Android apps and want a unified view.

Why does the Events entity take so long to load?

The Events entity uses Amplitude's Export API, which can be slow for large date ranges or high-volume projects. Reduce the request time range parameter to a smaller number of hours to break the request into smaller batches. Start with 6 hours and go lower if you still experience timeouts.

Can I use Amplitude data with AI tools?

Yes. Coupler.io supports AI destinations including ChatGPT, Claude, Gemini, Cursor, Perplexity, and OpenClaw. You can pipe your Amplitude events or active user data directly into these tools and ask natural language questions about user behavior, drop-off points, or engagement trends.

Why are my event_properties showing as a long string instead of separate columns?

Amplitude stores event and user properties as nested JSON objects. Spreadsheet destinations like Google Sheets display these as raw JSON strings. If you need individual property values as separate columns, consider exporting to BigQuery where JSON is natively supported, or use Coupler.io's transformation features to extract specific fields.

What's the difference between Events and Events list?

Events returns raw event records — every individual action a user took, with timestamps and properties. Events list returns the catalog of event types defined in your project (e.g., page_viewed, purchase_completed) along with total occurrence counts. Use Events list to audit your tracking taxonomy; use Events for behavioral analysis.

Can I join Amplitude data with data from another source?

Yes. Coupler.io's Join transformation lets you combine Amplitude data with data from other sources — for example, joining Amplitude Events with Salesforce or HubSpot CRM data on a shared user ID, or joining Active users with ad spend data from Google Ads to calculate cost per active user.

Does Coupler.io support historical backfills for Amplitude data?

Yes — set your start date using the date picker to any date after your Amplitude project was created. Keep in mind that very long historical ranges can trigger timeout errors for the Events entity. Pull history in chunks by adjusting the request time range parameter.

For details on what fields are available per entity, see Data Overview. If you're hitting timeout or connection errors, check Common Issues for specific fixes. For tips on structuring your data flow efficiently, see Best Practices.