Skip to contentSkip to navigationSkip to topbar
Page tools
Useful for sharing or LLM

On this pageProducts used
Looking for more inspiration?Visit the
Error
Application error

21626: Invalid 'StatusCallbackEvent'

Twilio Voice DocumentationVoice

Description

description page anchor

You passed one or more invalid values in StatusCallbackEvent for a Programmable Voice call. Use only initiated, ringing, answered, or completed. If you do not specify StatusCallbackEvent, Twilio sends the completed callback by default.

Possible causes

possible-causes page anchor
  • You sent a StatusCallbackEvent value other than initiated, ringing, answered, or completed.
  • You passed multiple callback events in an invalid format. For REST API calls, send each event in a separate status_callback_event parameter.
  • You used TwiML with an invalid statusCallbackEvent attribute value or formatting. When you specify multiple events in TwiML, separate them with spaces.
  • Replace invalid values with supported call progress events only: initiated, ringing, answered, and completed.
  • If you only need the final call result, remove StatusCallbackEvent and keep StatusCallback. Twilio sends the completed event by default.
  • If you create calls with the REST API, send each event as a separate status_callback_event parameter or use your helper library's array form for statusCallbackEvent.
  • If you use TwiML such as <Dial><Number>, <Dial><Sip>, or similar Voice call flows, provide multiple statusCallbackEvent values as a space-delimited list.

Additional resources

additional-resources page anchor