Configuring Phone Numbers to Receive Faxes

Newly purchased Twilio numbers are not configured to automatically receive faxes by default. Read on for instructions on changing this behavior.

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.

Configure a Phone Number to Block Incoming Faxes

There are a number of options for blocking or ignoring incoming faxes. For full details, please see our article How Can I Stop Receiving or Block Incoming Faxes.

 

Configure a Phone Number to Receive Faxes

Twilio Phone numbers require instructions for handling incoming faxes. To get these instructions, Twilio checks the configuration of each phone number when an inbound communication arrives. Here are the different options, and how to configure your phone number for each of them:

  • Webhook: Webhooks are applications at external URLs that respond Twilio's HTTP requests with coded instructions. This option is recommended for Twilio users who want a completely customizable Twilio application. For more information, please see our Webhooks Glossary page.
  • TwiML Bin: TwiML Bins allow you to write TwiML that Twilio will host for you - so you can quickly prototype a solution without spinning up a web server. This option is recommended for Twilio users who want to get a prototype up and running quickly, or those without their own web hosting. For more information, please see this TwiML Bins blog post.
  • Function (Beta): Functions are Twilio-hosted Node.js webhooks for responding to Twilio's HTTP requests with coded instructions. This option is recommended for Twilio users who don't have their own web hosting, and want a versatile solution that can be as simple or complex as needed. For more information, please see the Twilio Functions landing page.
  • TwiML App: TwiML Applications are a reusable set of URLs and other configuration data for responding to Twilio. They allows you to update the app only, and have these changes automatically roll out to each configured phone number. For more information, please see our Applications REST API Resource page.

How do you respond? Your Twilio response will vary depending on your use case and business needs. For more information on how Twilio Programmable Fax works, please see our tutorial Receiving Faxes.

Respond with a Webhook

  1. Login to your account at www.twilio.com/console.
  2. Click Phone Numbers Icon_Numbers.png from the left-side navigation bar.
    NOTE: If Phone Numbers is not visible, you may first need to click All Products & Services.
  3. Click the desired phone number to modify.
  4. Scroll to the Voice & Fax section, and then modify the phone number’s routing:
    Fax_1_webhook.png 
    • ACCEPT INCOMING: Faxes
    • CONFIGURE WITH: Webhooks, TwiML Bins, Functions, Studio, or Proxy
    • A FAX COMES IN: Webhook
    • INPUT FIELD: Enter the URL for your Twilio response code.
  5. When finished, click Save.

Respond with a TwiML Bin

  1. Login to your account at www.twilio.com/console.
  2. Click Phone Numbers Icon_Numbers.png from the left-side navigation bar.
    NOTE: If Phone Numbers is not visible, you may first need to click All Products & Services.
  3. Click the desired phone number to modify.
  4. Scroll to the Voice & Fax section, and then modify the phone number’s routing:
    Fax_2_TwiMLBin.png 
    • ACCEPT INCOMING: Faxes
    • CONFIGURE WITH: Webhooks, TwiML Bins, Functions, Studio, or Proxy
    • A FAX COMES IN: TwiML
    • DROP-DOWN MENU: Select the previously saved TwiML Bin.
      NOTE: A new TwiML Bin may not be immediately visible; try refreshing the page if you don't see it at first.
  5. When finished, click Save. 

Respond with a Function

  1. Login to your account at www.twilio.com/console.
  2. Click Phone Numbers Icon_Numbers.png from the left-side navigation bar.
    NOTE: If Phone Numbers is not visible, you may first need to click All Products & Services.
  3. Click the desired phone number to modify.
  4. Scroll to the Voice & Fax section, and then modify the phone number’s routing:
    Fax_3_Function.png 

    • ACCEPT INCOMING: Faxes
    • CONFIGURE WITH: Webhooks, TwiML Bins, Functions, Studio, or Proxy
    • A FAX COMES IN: Function
    • DROP-DOWN MENU: Select the previously saved function.
      NOTE: A new Function may not be immediately visible; try refreshing the page if you don't see it at first.
  5. When finished, click Save.

Respond with a TwiML App

  1. Login to your account at www.twilio.com/console.
  2. Click Phone Numbers Icon_Numbers.png from the left-side navigation bar.
    NOTE: If Phone Numbers is not visible, you may first need to click All Products & Services.
  3. Click the desired phone number to modify.
  4. Scroll to the Voice & Fax section, and then modify the phone number’s routing:
    Fax_4_TwiMLApp.png 

    • ACCEPT INCOMING: Faxes
    • CONFIGURE WITH: TwiML App
    • TWIML APP: Select the previously saved TwiML App.
      NOTE: A new app may not be immediately visible; try refreshing the page if you don't see it at first.
  5. When finished, click Save.

 

Have more questions? Submit a request
Powered by Zendesk