POST /api/calls
Content-Type: application/json
Authorization: Bearer <token>

{
  "audioUrl":       "https://your-crm.com/recordings/call-001.mp3",  // required · must be unique per agent
  "agentEmail":     "rahul.sharma@company.com",                       // required · unique key
  "agentName":      "Rahul Sharma",                                   // optional
  "clientName":     "Anita Verma",                                    // optional · learner / client name shown across all dashboards
  "source":         "Facebook",                                       // optional · lead source (filterable)
  "customerEmail":  "anita.verma@gmail.com",                           // optional · learner / lead email (filterable)
  "courseName":     "MBA in Data Science",                             // optional · programme / course the lead is enquiring about
  "callDate":       "2026-05-09T10:30:00Z",                          // optional · accepts ISO-8601, "27/11/2025" (DD/MM/YYYY), or "2025-11-27"
  "disposition":    "Interested",                                    // optional · top-level VCRM tag
  "subDisposition": "Need more counselling"                         // required when disposition set · powers scenario-based scoring
}

// Valid dispositions: New, Call-Back, Non Contactable, Interested, Prospect, IP Fallout, Fallout, Converted, Churn Interested
// Get the full tree at GET /api/dispositions (returns disposition → sub-disposition map)

✓ New call:
{ "success": true, "duplicate": false, "callId": "uuid", "status": "pending" }

⚠ Duplicate (HTTP 409):
{
  "success": false,
  "duplicate": true,
  "message": "Already submitted for this agent",
  "existingCall": { "callId": "...", "status": "done", "overall_score": 72 }
}

// Get an auth token first:
POST /api/auth/login
{ "email": "<your-login-email>", "password": "<your-password>" }
→ { "success": true, "token": "abc-123-...", "user": {...} }