Skip to contentSkip to navigationSkip to topbar
Page toolsOn this pageProducts used
Looking for more inspiration?Visit the

21609: Invalid 'StatusCallback'


ERROR: 21609

error-21609 page anchor
MESSAGING
ERROR

This error occurs when the StatusCallback value in your Message request isn't a valid URL. Use a fully qualified public URL with a valid hostname. Keep the URL at 4000 characters or fewer.

Possible causes

possible-causes page anchor
  • The StatusCallback value isn't a valid URL.
  • The URL is longer than 4000 characters.
  • The URL is missing part of a fully qualified address, such as the protocol, hostname, or path.
  • The query string includes characters that aren't properly URL-encoded.
  • The hostname is invalid. For example, it contains underscores.
  • The endpoint isn't publicly reachable.
  • Set StatusCallback to a fully qualified http:// or https:// URL.
  • Use a valid hostname and remove unsupported characters such as underscores.
  • Shorten the URL so it stays within the 4000-character limit.
  • URL-encode query parameters before you submit the request.
  • Make sure your endpoint is reachable from the public internet.
  • Test with a temporary public webhook endpoint to confirm that Twilio can send callbacks. If that test succeeds, review your application logs, firewall rules, authentication requirements, and SSL configuration on your original endpoint.

Additional resources

additional-resources page anchor