Skip to content
SNOW Docs

Quickstart

Make your first SNOW API call in 5 minutes.

1. Get an API key

Section titled “1. Get an API key”
  1. Log into platform.snowmed.health using Google OAuth
  2. Navigate to API keys
  3. Click Create key
  4. Pick Test mode (sn_test_*) for development; switch to Live mode (sn_live_*) when ready for production
  5. Copy the key — it’s shown once

2. Mint your first session

Section titled “2. Mint your first session”

The simplest possible flow: a hosted single-submit pre-visit form.

Terminal window
curl -X POST https://api.summary.to/v1/intake-sessions \
  -H "Authorization: Bearer sn_test_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{"specialty":"obstetrics"}'

Response:

{
  "session_id": "aae5c6ed-51ad-4773-b73b-62101b82e29a",
  "token": "9jiGQhmCV9VEDNR0bK4UT6gI",
  "intake_url": "https://previsit.summary.to/intake/9jiGQhmCV9VEDNR0bK4UT6gI",
  "specialty": "obstetrics",
  "expires_at": "2026-05-08T09:09:22.706Z",
  "created_at": "2026-05-08T08:09:22.709Z"
}

3. Open the URL in a browser

Section titled “3. Open the URL in a browser”

Open intake_url in any browser — you’ll see the obstetrics intake form (multilingual, single-submit). Fill it in, submit, and the patient sees a thank-you screen.

4. Configure a webhook receiver

Section titled “4. Configure a webhook receiver”

In production, you’d send the URL to the patient via WhatsApp/SMS, then receive the summary via webhook when they submit.

Configure your receiver:

Terminal window
curl -X PUT https://api.summary.to/v1/me/webhook \
  -H "Authorization: Bearer sn_test_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://your-app.example.com/webhooks/snow"}'

Save the returned whsec_* secret — it’s used for HMAC verification on incoming deliveries.

5. Receive the summary

Section titled “5. Receive the summary”

When the patient submits, SNOW emits these events to your webhook:

  • intake_session.submitted — patient has finished the form
  • intake_session.completed — summarization done, structured summary payload included

Verify the HMAC signature in your handler. See the integration guide for full lifecycle examples and signature verification code.

Next steps

Section titled “Next steps”