> For the complete documentation index, see [llms.txt](https://docs.tryterra.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tryterra.co/faq/help-topics/connecting/apple-health-health-connect-and-mobile-sdk/apple-health-permission-screen-build-config.md).

# Why does Apple Health permission never show with success:false?

If Apple Health's permission prompt never appears and `initConnection` returns `success:false`, check two things:

{% stepper %}
{% step %}
**Verify the HealthKit capability and `info.plist` keys are present in the actual built app**, not just the project config. The build process can strip or fail to include Apple Health permissions.
{% endstep %}

{% step %}
**Call `initConnection` from the main UI thread.** The permission screen is a main-thread-blocking component, so a busy thread can cause a timeout.
{% endstep %}
{% endstepper %}

See the [iOS SDK reference](https://docs.tryterra.co/health-and-fitness-api/mobile-only-sources/ios-swift) for setup details.
