Skip to main content

Webhook URL

An Application's webhook_url is the destination that receives asynchronous MiniVoice call, gather, and recording events. Configure webhook_secret to enable signed delivery.

{
  "name": "Support IVR",
  "answer_url": "https://example.com/minivoice/answer",
  "webhook_url": "https://example.com/minivoice/webhooks",
  "webhook_secret": "replace-with-a-random-secret"
}

MiniVoice validates the destination when the Application is configured and again before delivery or manual resend. The URL must be a valid public HTTP or HTTPS destination; HTTPS is required unless insecure HTTP has been explicitly enabled for that Application. Invalid, private, or internal destinations can be rejected.

Your endpoint should:

  • accept POST requests with JSON bodies
  • preserve the raw body for signature verification
  • deduplicate using the event id
  • return any 2xx status after accepting the event
  • process long-running work asynchronously

Most 4xx responses are final. Network failures, timeouts, 408, 425, 429, and 5xx responses follow the automatic retry policy.

Continue with the Webhooks Overview or use the Webhook Inspector to diagnose a delivery.