Help

Support

Covers HC Webhook (Android) and Health Webhook (iOS).

Get in touch

Not finding an answer below? Reach out directly — we typically respond within 24 hours.

Android

HC Webhook is not syncing. What should I check?: Open the Logs tab in the app — it shows any errors from your last sync. Also check that health data permissions are granted (Android Settings → Apps → HC Webhook → Permissions). On some devices, disabling battery optimization is required for background sync.
How do I grant health data permissions on Android?: Go to Android Settings → Apps → HC Webhook → Permissions, or open the health data settings on your device and find HC Webhook under connected apps. Enable each data type you want to sync.
My webhook is not receiving data.: Open the Logs tab in HC Webhook — it shows the HTTP status code and any error returned by your endpoint. Check that the URL is reachable from your phone and that your server is accepting POST requests.
How do I export or back up my settings?: Go to Settings → Backup → Export Settings. This creates a JSON file you can save or share. Use Import Settings on any device to restore.

iOS

Health Webhook for iOS is not syncing automatically.: iOS sync runs via the Shortcuts app. Open Shortcuts → Automation, find your Health Webhook automation, and confirm it is enabled. Make sure the "Ask Before Running" toggle is off if you want it to run silently.
How do I set up automatic sync on iPhone?: Open the Shortcuts app → Automation tab → tap + → New Automation → choose a time trigger → tap Add Action → search "Sync Health Data" → select the Health Webhook action → tap Done. The automation will run on your chosen schedule.
Apple Health permissions are not showing.: Go to the Home tab in the app, tap "Manage Permissions", then navigate to your iPhone Settings → Privacy & Security → Health → Health Webhook and enable each data type you want.
The payload shows "platform": "ios" — is that normal?: Yes. Health Webhook for iOS adds a platform field to distinguish payloads from the Android version. The rest of the schema is identical.

How is the JSON payload structured?: Each sync sends a JSON object with a timestamp field and one array per enabled data type (e.g., steps, heart_rate). Only types with data in the sync window are included. See the data types reference for full sample payloads.
Can I test my webhook without a real device?: Yes. You can use a free service like webhook.site to inspect incoming requests. Paste the URL into the app, trigger a manual sync, and view the raw payload in your browser.
How do I connect to Home Assistant?: Create a webhook trigger in Home Assistant (Settings → Automations → Create → Trigger: Webhook) and copy the generated URL. Paste it into the app. See the Home Assistant integration guide for a full walkthrough.