SUPPORT.TWILIO.COM END OF LIFE NOTICE: This site, support.twilio.com, is scheduled to go End of Life on February 27, 2024. All Twilio Support content has been migrated to help.twilio.com, where you can continue to find helpful Support articles, API docs, and Twilio blog content, and escalate your issues to our Support team. We encourage you to update your bookmarks and begin using the new site today for all your Twilio Support needs.

Error: “Telephony_provider_permission” When Integrating Twilio Numbers With Third-Party Platforms

Issue

When connecting your Twilio phone number to a third-party service (such as Retell AI or similar platforms) for making or receiving calls, you may encounter the error:  

Telephony_provider_permission

This article explains what this error means, why it occurs, and how to resolve it.

What Does “Telephony_provider_permission” Mean?

This error typically indicates that the third-party platform (e.g., Retell AI) was unable to complete a call using your Twilio number due to a permissions or configuration issue between the two services.  

It is not a standard Twilio error, but rather a message from the third-party platform indicating a problem with the telephony provider integration.

 

Cause

  • Incorrect Account SID or Auth Token: The third-party platform may be using the wrong Twilio Account SID or Auth Token, or credentials from a different Twilio region.
  • Misconfigured Integration: The integration may not be pointing to the correct Twilio SIP Trunk Termination URI or endpoint.
  • Permissions Issue: The third-party platform may not have the necessary permissions to use your Twilio number for outbound or inbound calls.
  • Outdated or Invalid Credentials: The credentials used by the third-party platform may have expired or been changed.

 

Resolution

Follow these steps to troubleshoot and resolve the issue:

  1. Verify Credentials
  • Double-check that the Twilio Account SID and Auth Token entered in the third-party platform match those in your Twilio Console.
  • Ensure you are using credentials for the correct region (if applicable).
  1. Re-Integrate the Platform
  •  Remove the existing Twilio integration from the third-party platform.
  •  Re-add the integration, carefully entering the correct Account SID and Auth Token.
  1. Check SIP Trunk or Endpoint Configuration
  • If using SIP Trunking, confirm that the third-party platform is configured to point to the correct Twilio SIP Trunk Termination URI.
  • Using an incorrect URI or endpoint (Twilio or non-Twilio) will result in call failures.
  1. Review Platform Documentation
  •   Consult the third-party platform’s documentation for any Twilio-specific setup steps or requirements.
  1. Gather Logs for Further Investigation

   If the issue persists, collect relevant logs:

  •   API request logs from the third-party platform
  •   SIP PCAP traces (if available)
  •   Any error messages or screenshots
  1. Contact Platform Support
  • If you are unable to resolve the issue, share the collected logs with both the third-party platform’s support team and Twilio Support for further assistance.

 

Additional Information 

The Telephony_provider_permission error is usually caused by a configuration or credential mismatch between Twilio and the third-party platform. Carefully reviewing and correcting your integration settings will resolve most cases. If you continue to experience issues, gather logs and reach out for support with as much detail as possible.

Below you will find references to useful documents: 

 

Have more questions? Submit a request
We can’t wait to see what you build.
Powered by Zendesk