Skip to navigation

Telephony Errors

What each telephony error in your call logs means, and how to fix it.

When a call fails for a telephony reason, Synthflow records the error on the call. Open the failed call in Logs to see it, then find the message below. Each message follows the format Telephony - <SIP code> - <reason>.

  • 4xx errors come from the request: the number, the caller ID, or the account.
  • 5xx errors come from a server or network between you and the recipient.
  • 6xx errors mean the recipient’s network rejected the call.

To see where in the call the error happened, open its SIP Call Ladder.

4xx errors

Error messageWhat it meansHow to fix it
Telephony - 400 - Bad RequestThe request is malformed.Check the request format and parameters.
Telephony - 400 - Invalid phone numberThe number format is not valid, usually in the To header.Correct the number. Use E.164 format.
Telephony - 400 - The number +1234567 is unverified. Trial accounts may only make calls to verified numbers.Twilio trial accounts can only call verified numbers.Connect your own Twilio account.
Telephony - 401 - UnauthorizedAuthentication is invalid or missing.Check the SIP credentials on the custom number, or your Twilio credentials.
Telephony - 403 - Caller ID is unauthorized. A Valid Caller ID is either a DID you have purchased from Twilio or a verified Caller ID.Your caller ID is not verified.Use a number you purchased, or verify the caller ID in your account.
Telephony - 403 - ForbiddenYou do not have permission to place this call.Check your account permissions, or try a different number.
Telephony - 403 - Invalid credentialsThe authentication details are incorrect.Check your SIP or Twilio credentials.
Telephony - 403 - No International PermissionYour account cannot call this country.Enable calls to that country with your carrier. In Twilio, this is set in Voice Geographic Permissions.
Telephony - 403 - Phone number is blacklistedThe number is blocked.Use a different number.
Telephony - 404 - INVALID DNISThe destination number is invalid.Check the number and retry.
Telephony - 404 - No VoiceURLThe number has no URL for call instructions.Add a voice URL to the number in your Twilio account.
Telephony - 404 - Not FoundThe number does not exist or cannot be reached.Check the number format and retry.
Telephony - 404 - Service closed for this numberCalls to this number are not allowed.Use a different number.
Telephony - 408 - Request TimeoutCall setup took too long.Retry later, and check your network connection.
Telephony - 410 - GoneThe number is no longer in service.Get an updated number from the recipient.
Telephony - 480 - Temporarily not availableThe recipient did not answer before the ring timeout.Try again later.
Telephony - 481 - Call leg/Transaction does not existThe call reference is invalid or expired.Start a new call.
Telephony - 482 - Loop DetectedThe call routing created a loop.Check your SIP routing for loops.
Telephony - 483 - Too Many HopsThe call passed through too many hops.Check your SIP routing for loops.
Telephony - 484 - Address IncompleteThe dialed number is incomplete.Include the full number with country and area code.
Telephony - 484 - Call RejectedThe recipient rejected the call.Try later, or contact the recipient.
Telephony - 486 - Busy HereThe recipient’s line is busy.Call back later.
Telephony - 487 - Request TerminatedThe call was canceled before it connected.Start the call again if needed.
Telephony - 488 - Not Acceptable HereThe network cannot handle the call’s media.Check your codec settings and retry.

5xx errors

Error messageWhat it meansHow to fix it
Telephony - 500 - DeclineSomething went wrong on our side.Retry. If it persists, contact support.
Telephony - 500 - Internal Server ErrorSomething went wrong on our side.Retry. If it persists, contact support.
Telephony - 500 - Service UnavailableThe system or carrier is overloaded.Retry. If it persists, contact support.
Telephony - 501 - Not ImplementedThe request uses a feature that is not supported.Retry. If it persists, contact support.
Telephony - 502 - Bad GatewayA network issue occurred between systems.Retry. If it persists, contact support.
Telephony - 503 - No Routeplan FoundNo valid route was found for the call.Retry. If it persists, contact support.
Telephony - 503 - Service UnavailableThe system or carrier is overloaded.Retry. If it persists, contact support.
Telephony - 504 - Request TimeoutCall setup took too long.Retry. If it persists, contact support.

6xx errors

Error messageWhat it meansHow to fix it
Telephony - 603 - DeclineThe recipient’s network or device rejected the call.Retry. If it persists, contact support.
Telephony - 608 - RejectedThe call was rejected because of a network policy.Retry. If it persists, contact support.
Telephony - 608 - Termination needs STI IDHDRThe carrier requires a verified caller ID (STIR/SHAKEN).Retry. If it persists, contact support.