AMSh Platform v1.4.2•All APIs Operational (99.99%)

Developer Documentation & APIs

Connect your clinic telephony, WhatsApp Cloud channels, and Google Calendar to AMSh autonomous AI Virtual Employees. Built with low-latency WebSockets, Twilio Media Streams, and REST APIs.

GitHub SDKsGet API Keys →
GETTING STARTED

5-Minute Developer Quickstart

Integrate your clinic with AMSh in three straightforward steps: obtain your API credentials, configure your doctor roster, and forward your inbound phone lines or dispatch outbound calls.

1

Generate API Key

Access developer tokens in clinic dashboard with role-based scopes.

2

Sync Calendars

Connect Google Calendar or your EMR API for real-time doctor availability.

3

Forward Phone Lines

Point your Twilio, Exotel, Plivo or SIP trunk to AMSh WebSocket endpoint.

quickstart_init.sh
curl -X POST https://api.amsh.ai/v1/calls/dispatch \
  -H "Authorization: Bearer amsh_live_sec_9938217f2a" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+919876543210",
    "patient_name": "Rohan Verma",
    "persona_id": "priya",
    "context": {
      "clinic_name": "Sunrise Dental Care",
      "doctor_name": "Dr. Sharma",
      "purpose": "Appointment Confirmation"
    }
  }'
POST/api/v1/calls/dispatch

Initiates an autonomous outbound phone call to a patient using your clinic's AI Virtual Receptionist. Used for post-op checkups, recall reminders, and appointment re-confirmations.

FieldTypeRequiredDescription
tostringREQUIREDPatient phone number in E.164 format (e.g. +919876543210 or +14155552671)
from_didstringOPTIONALSpecific clinic DID to display on caller ID. Defaults to primary line.
persona_idstringOPTIONALVirtual employee persona ('priya', 'sarah', 'emma', 'fatima').
patient_namestringREQUIREDPatient full name for personalized greeting.
contextobjectOPTIONALClinical context e.g. { doctor: 'Dr. Sharma', service: 'Root Canal' }
webhook_urlstringOPTIONALOverride default webhook endpoint for this specific call lifecycle.
Request (curl)
curl -X POST https://api.amsh.ai/v1/calls/dispatch \
  -H "Authorization: Bearer amsh_live_sec_9938217f2a" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+919876543210",
    "patient_name": "Rohan Verma",
    "persona_id": "priya",
    "context": {
      "clinic_name": "Sunrise Dental Care",
      "doctor_name": "Dr. Sharma",
      "purpose": "Appointment Confirmation"
    }
  }'
Response (200 OK)Queued
{
  "status": "queued",
  "call_id": "call_amsh_8f912be4a",
  "to": "+919876543210",
  "persona_id": "priya",
  "carrier": "twilio_sip_trunk",
  "created_at": "2026-10-10T15:45:00Z",
  "stream_url": "wss://stream.amsh.ai/v1/voice/call_amsh_8f912be4a"
}
INTERACTIVE API SANDBOX

Test Live Receptionist Call API

● MOCK CARRIER ACTIVE