Getting Started with Twilio Programmable Fax (Beta)

Twilio Programmable Fax allows you to send and receive faxed documents from our REST API. Below is a simple introduction for getting started with Twilio Programmable Fax. For complete documentation, please refer to the full Twilio Programmable Fax API documentation.

Where is Programmable Fax Supported?

You can send and receive faxes for all locations that Twilio’s Super Network currently supports Voice and SIP Trunking. The To number can be any phone number that we can normally reach via our these products.

Supported Document Types

Programmable Fax currently only supports sending landscape black & white (no color) .PDF files.

Files sent via fax must be accessible by Twilio's proxy servers. Local files on your desktop are likely unaccessible via these methods, but may be uploaded to Twilio Assets for sending.

Sending a Fax

To send a fax, your application needs to make an HTTP POST request to Twilio’s Fax List REST API resource with three required pieces of information; A recipient, a sender, and some content.

  • Recipient: The To parameter consisting of the destination phone number (using E.164 formatting), or fax-capable SIP URI.
  • Sender: The From parameter consisting of a valid Twilio phone number (using E.164 formatting), or a verified outgoing caller ID.
  • Content: The MediaUrl parameter consisting of the URL of the .PDF file you wish to send.

For a basic example, please see our article Simple Example for Sending a Fax. For complete details, including optional parameters, please see our API reference guide.

Receiving a Fax

To receive a fax, you will need to respond to Twilio's incoming fax HTTP Requests with the <Receive> TwiML verb. For full details, please see our tutorial for Receiving Faxes.

Note: Twilio phone numbers can't be configured to receive both faxes and voice calls simultaneously. If you need to receive both calls and faxes, we recommend purchasing separate numbers dedicated to receiving faxes and calls.

Additional Resources

Have more questions? Submit a request
Powered by Zendesk