Garmin's New API Branding Guidelines: How Sahha Keeps You Compliant
Garmin's updated API requires device attribution. Sahha tracks all data sources automatically, making compliance simple for health data apps.
Garmin has introduced updated API Branding and Attribution Guidelines requiring apps to display device attribution when showing Garmin-sourced data.
The good news: If you’re using Sahha, you’re already set up for compliance. We track all data sources automatically.
What Garmin Requires
Garmin’s new guidelines require:
- Display “Garmin [device model]” next to any Garmin-sourced data
- Use official Garmin Connect logos and wordmarks
- Maintain Garmin’s brand color #6DCFF6
- Include Garmin attribution on exports and reports
- Attribution for derived/combined data that includes Garmin sources
Full guidelines: Garmin API Brand Guidelines
How Sahha Keeps You Compliant
At Sahha, all data sources are tracked and provided automatically. This makes Garmin compliance straightforward.
What Sahha Provides
Every time health data flows through Sahha, we capture:
- Device type - The specific device model (e.g., “iPhone13,2”, “Garmin Fenix 7”)
- Data source - The display name (e.g., “iPhone X”, “Garmin Connect”)
- Recording method - How the data was captured (automatic vs manual)
This information is available in your DataLogReceivedIntegrationEvent webhooks.
Where to Find Device Source Data
Device information is provided in the dataLogs
array of DataLogReceivedIntegrationEvent
:
Key fields:
deviceType
- Technical device identifiersource
- Human-readable source namerecordingMethod
- How data was recorded
View example data log structure
{
"logType": "activity",
"dataType": "step_count",
"externalId": "user-123",
"dataLogs": [
{
"id": "log-abc-123",
"value": 10000,
"unit": "count",
"deviceType": "iPhone13,2",
"source": "iPhone X",
"recordingMethod": "RECORDING_METHOD_AUTOMATICALLY_RECORDED",
"startDateTime": "2023-06-25T00:00:00+00:00",
"endDateTime": "2023-06-25T23:59:59+00:00"
}
]
}
Find complete webhook documentation: Sahha Webhooks Guide
Why Source Tracking Matters
Health scores combine multiple data inputs:
- Sleep duration and quality
- Activity patterns
- Recovery indicators
- Circadian alignment
When Garmin data contributes to these scores, you need to show attribution. Sahha captures the source information automatically, so you can display it when showing health insights to users.
What You Need to Do
1. Subscribe to DataLogReceivedIntegrationEvent
Enable webhook notifications in your Sahha dashboard to receive data log events.
Look for Raw data logs and check the device data checkbox.
2. Extract Device Information
When you receive webhook events, capture the deviceType
and source
fields from the data logs.
3. Store Device Sources
Save device information alongside your user data so you can display it later.
4. Display Attribution
Show device sources when displaying health scores:
- In score detail views
- In settings or “About this data” sections
- In exported reports and downloads
Example display:
- “Sleep Score: 82/100 - Data from iPhone via HealthKit”
- “Activity Score: 75/100 - Data sources: Garmin Fenix 7, iPhone”
Sahha’s Direct Garmin Integration (Coming Soon)
Currently, Sahha uses platform APIs (HealthKit and Health Connect) to access health data from all wearables, including Garmin devices.
We’re adding direct Garmin API integration to give you more options.
Two Integration Approaches
Platform API (current):
- Access all wearable data through HealthKit/Health Connect
- Device source tracking included
- Recommended for most apps
Direct Garmin API (coming soon):
- Direct connection to Garmin Connect API
- Full Garmin branding requirements apply
- Device source tracking included
- Same implementation pattern
The advantage: Whichever approach you choose, Sahha provides device source tracking automatically.
Need Help?
We’re here to support your integration and compliance needs.
Get Support
Join our community:
- Sahha Slack Community - Connect with other developers and the Sahha team
Contact us directly:
- Email: support@sahha.ai
- Contact Form
Resources:
- Sahha Documentation - Complete API reference and guides
- Webhook Reference - Detailed webhook payload documentation
- Sahha GitHub - Open source SDKs and examples
The Bottom Line
Garmin’s requirement: Display device attribution for Garmin-sourced data.
Sahha’s solution: All data sources tracked and provided automatically.
What you do:
- Subscribe to DataLogReceivedIntegrationEvent webhooks
- Extract
deviceType
andsource
from data logs - Store device information with user data
- Display attribution when showing health scores
Need help? Join our Slack community or email support@sahha.ai.
Learn more:
Building transparent, compliant health data infrastructure.