Terra API Best Practices

Production-tested guidelines for building with Terra API. Contains rules across 5 categories, prioritized by impact, distilled from a real multi-device integration.

When to Apply

Reference these guidelines when:

• Implementing or reviewing a Terra API webhook endpoint
• Designing storage for wearable health data (activity, sleep, daily, body, nutrition, menstruation, hormone, athlete)
• Building device connection flows (auth, deauth, reauth, scopes)
• Handling data from users with multiple connected devices
• Writing tests for a Terra API integration

Rule Categories by Priority