Tokbox Webhooks

generated: '2026-10-25'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://developer.vonage.com/en/getting-started/concepts/webhooks#decoding-signed-webhooks
sources:
- https://developer.vonage.com/en/getting-started/concepts/webhooks#decoding-signed-webhooks
- https://developer.vonage.com/en/getting-started/concepts/signing-messages
- https://developer.vonage.com/en/voice/voice-api/webhook-reference
- https://developer.vonage.com/en/api/verify.v2
description: 'Vonage (TokBox) provides webhook events primarily for the Voice API. Events are listed in the Voice API Webhook Reference and include
  call lifecycle statuses such as started, ringing, answered, busy, cancelled, unanswered, disconnected, rejected, failed, human/machine, timeout,
  completed, record, input, and transfer. Webhook deliveries are secured by default with signed webhooks: each request includes a JWT token in
  the Authorization header that is signed with the account’s signature secret. If a webhook endpoint is unreachable or returns an HTTP error,
  Vonage will retry the request once (answer, event, and fallback URLs have specific connect and socket time‑outs). For event webhooks, a retry
  is also attempted when the response status is 429, 502, 503, or 504.'
events:
- event: started
  description: Indicates that the call has been created.
- event: ringing
  description: The call destination is ringing.
- event: answered
  description: The call was answered.
- event: busy
  description: The called party is busy.
- event: cancelled
  description: The call was cancelled.
- event: unanswered
  description: The call was not answered.
- event: disconnected
  description: The call was disconnected.
- event: rejected
  description: The call was rejected.
- event: failed
  description: The call failed.
- event: human/machine
  description: Human or machine detection result.
- event: timeout
  description: The call timed out.
- event: completed
  description: The call completed.
- event: record
  description: Recording related event.
- event: input
  description: User input event.
- event: transfer
  description: Call transfer event.
delivery:
  signature: JWT token in the Authorization header (signed with the account’s signature secret)
  retries: Vonage retries a failed webhook request once; for event webhooks a retry is also performed when the response status is 429, 502, 503,
    or 504.
docs: https://developer.vonage.com/en/getting-started/concepts/webhooks#decoding-signed-webhooks