FAQ

Can I connect multiple CommCare project spaces in one data flow?

Yes. Add each project space as a separate source within the same data flow. Then use the Append transformation to stack the data into a single table. This is useful if your organization runs the same program across multiple regions, each with its own CommCare project.

Where do I find my CommCare API key?

Log in to CommCare HQ, click your username in the top-right corner, and go to Settings. You'll find an API Key section where you can view or regenerate your key. If you don't see this option, your account may not have API access — check your CommCare plan.

How does the start date filter work?

The start date filters Forms by their received_on timestamp and Cases by server_last_modified. Only records on or after your chosen start date are included. Use the date picker in the data flow settings to set this — there are no text-based date macros.

Why do my form columns change between exports?

CommCare form fields are dynamic — they're based on your app's form definition. If your CommCare app is updated with new or renamed questions, the column structure of your export will change to match. This can break formulas or dashboards that reference specific column names, so test after any app update.

Can I export data from a CommCare Community (free) plan?

No. CommCare's API is only available on paid plans (Standard and above). If you're on the Community plan, you'll receive a 403 Forbidden error when trying to connect. You'll need to upgrade your CommCare HQ subscription to use Coupler.io with CommCare.

Can I send CommCare data to AI tools for analysis?

Yes. Coupler.io supports AI destinations including ChatGPT, Claude, Gemini, Perplexity, Cursor, and OpenClaw. You can route your CommCare form submissions or case data directly to these tools — useful for summarizing field reports, identifying patterns in survey responses, or generating program narratives.

How do I connect form submissions back to the cases they updated?

Use the Join transformation in your data flow. Both the Forms and Cases entities include case_id — join on this field to create a combined dataset showing which forms were submitted for each case. This is the most effective way to build longitudinal program records.

Are deleted or archived cases included in the export?

This depends on your CommCare HQ plan and API permissions. In most cases, archived records are excluded from the default API response. If you need to audit deleted data, contact CommCare support directly — this isn't configurable within Coupler.io.

For details on all available fields and how to combine entities, see the Data Overview article. If you're hitting connection or permission errors, check Common Issues.