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 is currently in beta, and has 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
Toparameter consisting of the destination phone number (using E.164 formatting), or fax-capable SIP URI.
- Sender: The
Fromparameter consisting of a valid Twilio phone number (using E.164 formatting), or a verified outgoing caller ID.
- Content: The
MediaUrlparameter consisting of the URL of the .PDF file you wish to send.
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.