Getting Started with Twilio Programmable Fax

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.

Notice: Twilio Programmable Fax has launched for outbound faxes, as well as inbound faxes to Japan. Inbound faxes to other locales are still in beta, and have not yet been finalized. Support requests for beta and pre-release products are generally handled by our engineering team, and as such, response times are not guaranteed. For more information on Support limitations for beta and pre-release products, please see Twilio Beta Product Support.

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 documents that meet the following requirements:

  • Black and white - color documents are not supported
  • Portrait orientation - landscape orientation documents are not supported
  • .PDF files - other file types are not supported.

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