Partner Platform Overview
Welcome. This is the integration reference for partners building on the Stealth Health telemedicine, prescribing, and fulfillment platform. There are three integration tiers; pick the one that matches the relationship you want with your patients and the data you can handle.
Which integration is right for you?
Integration tiers at a glance
| Referral Tier | Clinical Tier | Prescriber-Partner | |
|---|---|---|---|
| Where the patient enrolls | Stealth-Health-hosted page | Stealth-Health-hosted page | Partner's own UI |
| Who collects intake | Stealth Health | Stealth Health | Partner |
| Who signs the prescription | Stealth Health physicians | Stealth Health physicians or partner prescribers | Stealth Health physicians |
| PHI exposure to the partner | None | Full (under BAA) | Full (under BAA) |
| BAA required | No (referral source agreement only) | Yes | Yes |
| Webhook events | referral.*, transaction.*, fulfillment.* | All clinical events including prescription.*, appointment.*, lab_order.*, messageThread.* | appointment.*, prescription.*, fulfillment.* |
| Best for | Affiliate sites, lead-gen, brand partners | Telemedicine platforms extending our clinical workflow | Platforms that already run their own intake and want a turnkey physician network |
Common building blocks
Across all three tiers you'll work with the same core primitives:
- Authentication —
X-Partner-ID+X-Api-Keyheaders, with HMAC-SHA256 signatures on all outbound webhooks. See each tier's auth section for the specifics. - Webhooks — every event has a unique
event_idand is signed withX-Stealth-Signature: sha256=.... Verify on receipt; dedupe onevent_id. Deliveries are configured against the webhook URL on your partner account. See the Glossary for the canonical event catalog. - IDs — partner-facing identifiers use stable prefixes:
ref_(referral),ptn_(patient),pres_(prescriber),appt_(appointment),lab_(lab order),PRX-(partner-submitted Rx),evt_(webhook event). See Glossary → ID Prefixes. - Environments —
https://sandbox.stealth.healthfor development (60 req/min);https://api.stealth.healthfor production (300 req/min).
Front-end embed (works alongside any tier)
Want the patient intake to live on your domain rather than redirecting to app.stealth.health? Use the Questionnaire Embed — a drop-in iframe component (Vanilla JS or React/npm) that renders any of our 18 intake questionnaires inside your page. Submissions write directly to Stealth Health, the patient is auto-redirected to the matching /enroll/<slug> catalog, and your referral.* webhooks fire exactly as documented in the Referral Tier guide. Your stack never sees PHI — only an opaque responseId returned in the onSubmit callback.
The embed pairs with all three integration tiers: it's the front-end delivery mechanism; the tier you pick determines what data and webhooks you can read on the back end.
Where to go next
- Referral Tier Integration Guide — start here if you only need to refer customers and track lifecycle status.
- Clinical Tier Integration Guide — full clinical visibility plus the alternate flow where you submit prescriptions written by your own prescribers. Now including lab orders, requisition PDFs, and biomarker results.
- Prescriber-Partner Integration Guide — your intake, our physicians.
- Partner SSO Integration Guide — single sign-on handoff from the Stealth-hosted portal into your own application. Identity-only for patients; identity plus license metadata for prescribers and doctors. No patient PHI.
- Questionnaire Embed Integration Guide — drop-in iframe (Vanilla JS or React/npm) for hosting Stealth Health intake on your own domain.
- Glossary — status lifecycle, ID prefixes, webhook event catalog, signature header reference.
- Changelog — what's changed in the API.
Contact
- General partner onboarding: partners@stealth.health
- Security and breach notification: security@stealth.health