Voice OTP for iOS

Send a Voice OTP from iOS

Never put the API key in the app. The app calls your backend, and your backend calls Edesy (see the Node.js or Python example).

// iOS (Swift): call YOUR backend, which calls Edesy
var request = URLRequest(url: URL(string: "https://your-backend.com/api/otp/voice")!)
request.httpMethod = "POST"
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = try JSONEncoder().encode(["phone": phone])
let (_, response) = try await URLSession.shared.data(for: request)
guard (response as? HTTPURLResponse)?.statusCode == 200 else { throw OTPError.failed }

The result arrives on your webhook

Status is one of delivered, no-answer, busy or failed. dtmf_response is set when you enable press-1 confirmation.

POST https://your-app.com/webhooks/voice-otp
X-Edesy-Event: voice-otp.completed
Content-Type: application/json

{
  "id": "5b1c...-uuid",
  "external_id": "signup-123",
  "phone_number": "9876543210",
  "status": "delivered",
  "dtmf_response": "1",
  "duration_sec": 18,
  "price": "1.5000",
  "completed_at": "2026-09-26T10:15:30Z"
}