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

Was this helpful?

  1. Getting Started

Account setup and API keys

This guide walks you through creating your Terra account and obtaining the API keys necessary to start integrating with our services.

PreviousWhat is Terra API?NextCore concepts

Last updated 20 days ago

Was this helpful?

1

Create your Terra API account

  • Sign Up: Create an account at the Terra API .

  • Onboarding: Follow the Terra the onboarding flow and fill in the required information (email, password, company details, etc.) when prompted.

2

Select plan

  • Setup: During onboarding you'll be prompted to select your plan and enter billing details. Select the plan that best fits your requirements.

  • Manage plan: Once signed up, you can manage view your current plan and billing details within the Terra Dashboard under Settings. Ensure your account and subscription are active to maintain uninterrupted API access.

3

Obtain API keys

  • Get keys from dashboard: Once your account is setup, go to the and click on API Keys in the Navbar. Here you can copy your Developer ID and API Keys.

  • Credentials per environment: Terra maintains separate credentials for testing, staging, and production environments. There is a on testing and staging.

4

Start using Terra API!

  • Follow API Docs: You're now all set to use Terra API. We recommend that you start with the

  • Keep secret: Never share your x-api-key publicly or embed it directly in client-side code (e.g., mobile apps, frontend JavaScript).

  • Backend Use: API keys requiring this level of access (like your main x-api-key) should typically be used only from your secure backend server.

Registration Page
Terra Dashboard
user cap
Health & Fitness API.