Skip to content

Quickstart

  1. Get your API key from the SNOW Console under Settings → API Keys. It starts with sn_live_ for production or sn_test_ for sandbox.

  2. Create a pre-visit session

    Terminal window
    curl -X POST https://api.snowmed.io/v1/sessions/previsit/patient \
    -H "Authorization: Bearer sn_live_your_key" \
    -H "Content-Type: application/json" \
    -H "Idempotency-Key: test-001" \
    -d '{
    "patient": { "name": "Priya S", "phone": "+919876543210" },
    "clinic": { "doctor": "Dr. Padmavathi", "display_name": "My Clinic" }
    }'
  3. Send the link — take session_url from the response and open it in your browser. You’ll see the patient intake form exactly as your patients will.

  4. Register a webhook in the SNOW Console under Settings → Webhooks. Point it to a service like webhook.site for testing.

  5. Submit the form and watch the session.completed event arrive at your webhook endpoint.

  6. Fetch the result

    Terminal window
    curl https://api.snowmed.io/v1/sessions/{id} \
    -H "Authorization: Bearer sn_live_your_key"

    Check result for the structured summary and safety.requires_review before displaying it.