Managing user health data

Access user health and fitness information from Terra and, where supported, write data back to connected services.

Once your integrations are setup and you're successfully authenticating users, the next step is to interact with their health and fitness data. This section covers the methods for accessing the data Terra collects and the procedures for sending data back to supported providers.

---

Retrieving user data

Receiving data events (automatic updates)

• Learn how Terra automatically pushes new health and fitness data as events to your configured destination whenever it becomes available from a user's connected source (e.g. via Webhooks). This is the primary method for receiving ongoing user data.

Requesting historical data

• Understand how to make API requests to fetch batches of past data for a user. This is useful for initial data backfills, analytics, or ad-hoc data retrieval.

---

Writing data

Writing data to user accounts (e.g. planned workouts)

• Understand how to use Terra to send data, such as planned workouts, from your application back to a user's account on their fitness platform.