This article describes the in-depth setup of Programmable Fax / Applications on your Mission Control Portal in order to send and receive faxes via our API.

The Programmable Fax applications section is located on the left hand side of the portal.

Click on this button below and it will directly get you to the Programmable Fax Applications page.

There are 4 sections which you can configure:

Click on " Create your first application" and assign a name to this application to better manage the application. You also have access to the quickstart guide on the top right as well as the Application ID which will be required for API Interactions.

You will need to input a URL where all the webhook events will be sent. Also, you can setup a fail-over URL. If two consecutive delivery attempts to the primary URL fail, Telnyx will attempt delivery to this URL. NOTE: Must include a scheme such as 'https'.

Specify time, in seconds, for Telnyx to wait for a response to a webhook request.

​

"Latency" directs Telnyx to route media through the site with the lowest round-trip time to the user's connection. Telnyx calculates this time using ICMP ping messages. This can be disabled by specifying a site to handle all media.

Enable capture of RTCP reports to build QoS Reports (found under Debugging > SIP Call Flow Tool)

Specify the timezone and customer name which will be included in your programmable outbound faxes on the recipients side.

You can configure your global application settings for inbound calls over here.

Specify a subdomain that can be used to receive calls to a Connection, in the same way a phone number is used, from a SIP endpoint.

You can limit the total number of inbound calls to phone numbers associated with this connection.

Specify whether you want Telnyx to deliver your inbound faxes as a PDF or TIFF file type.

Assign your application to an outbound voice profile in order to make outbound calls.

You can limit the total number of outbound calls to phone numbers associated with this connection.

Don't forget to assign the fax application to your purchased numbers, in order to receive faxes to your application and for Telnyx to send the webhook events when faxes are received to our network.

Check out our fax API quick-start guide here and more detail on the API endpoints in our developer center.

Once you've successfully created your Fax application, it is given an application id that can be seen within the application settings as seen in the below picture.

The Fax application id is used to reference or trigger your API calls programmatically. Don't forget to reference our developer documentation to see how you can control your faxes.

You can see the specific endpoints here: