HIhippocraticai
Webhooks

Call Summary Webhook

Hippocratic AI sends call summary data to the partner's webhook endpoint after completing a patient interaction. Partners should implement this webhook endpoint to receive call summaries.

Retry Policy: If the webhook delivery fails (non-2xx response or network error), Hippocratic AI will automatically retry the delivery 3-5 times with 30-minute intervals between attempts. After the maximum retry attempts, the delivery will be marked as permanently failed.

Compatibility

  • New optional fields and enum values may appear without notice. Partners MUST ignore unknown fields and unknown enum values.
  • Field removals, type changes, and enum-value removals are breaking and will be coordinated in advance.
  • Optional fields are typically sent as "" / [] rather than omitted. Treat both as "no value".
  • A partner receives exactly one of the two contracts (call-summary or call-summary-legacy). Confirm with your DA. Payloads are not interchangeable.
  • Deliveries may be retried after non-2xx responses. call.call_id is stable across retries — deduplicate on it.
  • The V2 version field signals major contract changes only. Field and enum additions do not bump it.
postWebhookcall-summary

Payload

versionstring required

Call summary format version

Example payload

{
  "version": "2.0",
  "call_summary": {
    "call_id": "3b13f7a1-39aa-4a1a-8419-20e42c5b3f9b",
    "customer_patient_id": "XX0101506",
    "patient_name": {
      "last": "Smith",
      "first": "John"
    },
    "date_of_birth": "1937-04-22",
    "language": "en",
    "datetime_of_call": "2025-08-20 07:38 PM EDT",
    "call_duration_seconds": "232",
    "initiated_by_patient": true,
    "physician_name": "",
    "conversation_summary": "Patient reports they have filled their Simvastatin and Metformin prescriptions...",
    "enhanced_disposition": "call_hung_up",
    "gender": "male",
    "phone_number": "+15125551212",
    "care_location_name": "Test Location",
    "call_url": "https://portal.us.hippocraticai.com/call/3b13f7a1-39aa-4a1a-8419-20e42c5b3f9b",
    "call_type": "preop_ortho",
    "do_not_call": false,
    "medication_summaries": [],
    "device_summaries": [],
    "summary_question_answers": [],
    "follow_up_items": [],
    "todo_summaries": [],
    "escalation_summaries": [],
    "form_fill_summaries": [],
    "custom_variables": {},
    "hippocratic_ids": {
      "patient_id": "xxx",
      "partner_id": "xxx",
      "partner_care_location_id": "xxx",
      "script_id": "xxx",
      "agent_id": "xxx",
      "outreach_id": "xxx",
      "scenario_id": "xxx"
    }
  }
}

Response

Webhook received and processed successfully

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.