Overview

Get Started

Welcome to Sahha. In just a few steps, you’ll be collecting and analyzing health, lifestyle, and fitness data to create next-generation, hyper-personalized experiences.

1. Register your Team

Invite your team members

Sign up to the Sahha Dashboard and add your team members under Users .

2. Get your API Keys

Find your keys on the Credentials page .

  • Use your Sandbox Client ID and Sandbox Secret to request an account token . This token is required for account-level API tasks such as:
    • Registering or deleting profiles
    • Retrieving profile data and outputs
  • When moving to production, swap your Sandbox keys for your Production keys — no code changes required.

For more details, see the REST API Guide .

3. Choose a Data Source

Get started with Sahha in the way that works best for you:

  • Demo App → experience Sahha’s outputs with your own device data.
  • Sample Profiles → explore Sahha’s outputs instantly with simulated personas.
  • SDK Integration → embed Sahha in your app to unlock live user data.

a) Sahha Demo App

Experience Sahha with your own data. Install the Demo App and sync data from your personal device into the Dashboard.

  • Scan the QR code on the Demo App page to install and auto-link your profile.
  • Synced data appears as a new profile under Profiles .

b) Sample Profiles

Generate synthetic data instantly. Each sample profile simulates a persona (e.g., “Healthy Young Adult”) so you can see Sahha’s pipeline in action without SDK setup.

  • Create one or more profiles from the Action button next to Sample Profiles on the Profiles page.

c) SDK Integration

Integrate Sahha directly into your app using this guide .

  • Authenticate profiles using your Application ID and Secret from the Credentials page .

4. Choose a Data Delivery Method

Choose how you’d like Sahha data delivered into your product:

  • Webhooks → real-time push delivery to your backend (recommended).
  • REST API → on-demand access to data when you need it.
  • UI Widgets → ready-to-use visual components for your app.

Real-time delivery to your backend. Webhooks automatically push updates from Sahha whenever new data is available — no polling required.

  • Setup :
    1. Add a webhook endpoint in your backend.
    2. Register it on the Webhooks page in the Dashboard.
    3. Select the data points you’d like delivered and ensure your endpoint accepts POST requests.

For the full list of events available, see the Webhooks Guide .

b) REST API

Access any data on demand with secure API calls. Use the API Query Builder in the Dashboard to construct ready-to-use queries.

  • Authentication : Request an account or profile token with your Client ID + Secret , then use the token to authenticate API calls.
  • Error Handling : Handle authentication errors, rate limits, or invalid requests gracefully.
  • Example : /profile/scores → fetch scores for a given profile.

For the full list of endpoints available, see the REST API swagger .

c) UI Widgets

Pre-built webviews you can drop into your app to show Sahha data instantly.

  • Example : /arc → display a single score in a semi-circular arc.

For the full list of widgets avaiable, see the Widgets Guide .

5. Join the Community

The fastest way to get support and stay connected is through our Slack Community .

  • Chat directly with the Sahha team.
  • Get faster responses than email.
  • Connect with other builders using Sahha.

Get Support

You can also reach us at support@sahha.ai .

For SDK bugs or feature requests, use GitHub issues .

We’re here to help you build with Sahha.

Next
Data Dictionary