Which health metrics are supported by this skill?

It provides handlers and payload examples for activity, sleep, body metrics, daily summaries, nutrition, menstruation, and user profile updates.

What is the primary purpose of the terra-webhooks skill?

It provides a standardized approach for handling real-time health data deliveries from the Terra API, including signature verification and specific logic for different event types.

How does it handle security?

The skill includes implementation for HMAC-SHA256 signature verification and IP whitelisting of Terra's delivery servers to ensure data integrity and authenticity.

Does it support asynchronous processing?

Yes, it includes patterns for queuing webhooks using Celery to ensure your endpoint responds within Terra's required 5-second window while processing data in the background.

Terra Webhook Handler

Name: Terra Webhook Handler
Author: adaptationio

byadaptationio

0•

API Development

Streamlines the integration of real-time health and fitness data from the Terra API through secure webhook handling and event processing.

The terra-webhooks skill provides developers with a standardized framework for managing real-time data streams from the Terra API, which aggregates data from wearables like Fitbit, Garmin, and Oura. It includes production-grade patterns for Flask and Celery, covering everything from HMAC-SHA256 signature verification and IP whitelisting to specific event handlers for activity, sleep, and body metrics. This skill is essential for developers building health-tech applications who need to ensure reliable, secure, and idempotent processing of asynchronous health data.

Key Features

01Production-ready Flask and Celery boilerplate for async processing

02Idempotency logic to prevent duplicate data processing across retries

03Secure HMAC-SHA256 signature verification for webhook payloads

04Standardized handlers for authentication, activity, sleep, and daily metrics

05Built-in IP whitelisting for Terra API source addresses

060 GitHub stars

Use Cases

01Building real-time fitness dashboards that sync with various wearable providers

02Creating scalable health data ingestion pipelines for research or clinical monitoring

03Automating user lifecycle management including connection, de-authentication, and re-authentication

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add adaptationio/skrillz terra-webhooks

For use in Claude.ai and ChatGPT

Download Skill