Terra Docs
Dashboard
  • Docs
  • API Reference
  • Changelog
  • Getting Started
    • What is Terra API?
    • Account setup and API keys
    • Core concepts
  • Health & Fitness API
    • Overview
    • Quickstart
    • Integration setup
      • Understanding sources and destinations
      • Setting up data sources
      • Setting up data destinations
        • Webhooks
        • SQL database (Postgres, MySQL)
        • Supabase
        • Cloud storage (S3, GCP)
        • Queuing services (SQS, Kafka)
      • Customising data types
      • Dedicated data source API keys
      • Understanding Terra environments
    • User authentication
      • Authentication flow
      • Implementation (Terra widget)
      • Implementation (Custom UI)
      • Handling authentication events
      • Customising authentication redirects
    • Managing user health data
      • Receiving health data updates (events)
      • Requesting historical health data (REST API requests)
      • Writing data
    • Mobile-only sources
      • iOS (Swift)
      • Android (Kotlin)
      • React Native
      • Flutter
    • Troubleshooting
    • Pricing
  • User Engagement
    • Health Scores
  • Streaming API
    • Overview
    • Wearable -> Your app
      • iOS (Swift)
      • Android
    • Your app -> Terra
      • iOS (Swift)
      • Android
    • Terra -> Your backend
  • Teams API
  • Biomarkers API - Upcoming
Powered by GitBook
On this page
  • Overview
  • Set up Data Destination
  • Destination-specific steps

Was this helpful?

  1. Health & Fitness API
  2. Integration setup

Setting up data destinations

PreviousSetting up data sourcesNextWebhooks

Last updated 1 month ago

Was this helpful?

Overview

Terra’s Health & Fitness API is event-based; meaning it pushes all user health payloads via events directly to your data destination and removes the need to request data via the API.

Therefore, setting up data destinations is a core step in your integration process.

Terra API provides many options for data destinations such as webhooks, SQL databases, Supabase, and buckets.

In this section, you'll learn how to set up your preferred destination in your Terra Dashboard.


Set up Data Destination

  • Head to .

  • Click on "Add New", and select from 10 data destinations: Webhook, Database, Bucket and other.

  • Add the necessary details and click on "Apply".

You don't have a data destination yet?

No worries! If you are just starting off building your product and want to test how Terra works, you can use to set up a temporary destination for Webhooks.

For further information about each destination, please see in the Reference page.


Destination-specific steps

Terra API supports various data destinations, some require additional steps to setup correctly. Click each for further information and detailed setup instructions:

  • The most basic destination. Terra makes a POST request to your specified URL with new data events.

  • Store structured data directly into your PostgreSQL or MySQL databases. Terra can manage table creation and data insertion, providing download links for full payloads.

  • Leverage the combined power of Postgres and S3-compatible storage. Terra integrates seamlessly to manage both your database entries and raw data payloads within Supabase.

  • Dump raw data payloads directly into your preferred cloud storage bucket (AWS S3, Google Cloud Storage, or Azure Blob). Suitable for archival, batch processing, or data lake strategies.

  • Integrate with managed message queues like AWS SQS or Kafka for resilient, scalable, and asynchronous data ingestion into your existing event-driven architectures.

Webhooks
SQL database (Postgres, MySQL)
Supabase
Cloud Storage (AWS S3, GCP GCS, Azure Blob)
Queuing services (AWS SQS, Kafka)
your Terra Dashboard > Connections page
https://webhook.site
Destinations