> For the complete documentation index, see [llms.txt](https://docs.coupler.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coupler.io/sources/category/other/commcare/faq.md).

# FAQ

<details>

<summary>Can I connect multiple CommCare project spaces in one data flow?</summary>

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.

</details>

<details>

<summary>Where do I find my CommCare API key?</summary>

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.

</details>

<details>

<summary>How does the start date filter work?</summary>

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.

</details>

<details>

<summary>Why do my form columns change between exports?</summary>

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.

</details>

<details>

<summary>Can I export data from a CommCare Community (free) plan?</summary>

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.

</details>

<details>

<summary>Can I send CommCare data to AI tools for analysis?</summary>

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.

</details>

<details>

<summary>How do I connect form submissions back to the cases they updated?</summary>

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.

</details>

<details>

<summary>Are deleted or archived cases included in the export?</summary>

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.

</details>

{% hint style="info" %}
For details on all available fields and how to combine entities, see the [Data Overview](/sources/category/other/commcare/data-overview.md) article. If you're hitting connection or permission errors, check [Common Issues](/sources/category/other/commcare/common-issues.md).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.coupler.io/sources/category/other/commcare/faq.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.