Skip to main content

Quickstart Guide for Programmable Fax

In this guide, you’ll learn how to get started with Telnyx Programmable Fax within the Telnyx Portal. Just follow these simple steps:

  1. Sign up for a Telnyx Account.
  2. Create a Programmable Fax Application to configure how you connect your calls.
  3. Buy or port a Phone Number.
  4. Assign your number to the Programmable Fax Application.
  5. Create an Outbound Voice Profile to configure your outbound call settings and assign it to your Programmable Fax Application.

Step 1: Sign Up for a Telnyx Mission Control Portal account

Head to to sign up for your free Telnyx account. It’ll give you access to our Mission Control Portal where you can buy phone numbers, set up and manage Programmable Fax Applications, and more.

Step 2: Create a programmable fax application in the Telnyx portal

Step 3: Buy a phone number

You can search for, buy, and provision new numbers, or port existing numbers - all within the Numbers section of the Telnyx Portal .

Simply click on "Numbers", then either "Search & Buy Numbers" or "Port Numbers" and follow the prompts.

You can also do this programmatically via our RESTful API. Check out our documentation for number searching and ordering.

Step 4: Assign your phone number to the programmable fax application

Once your number has been purchased or ported, assign it to the Programmable Fax Application that you created in step 2. You can do this via the My Numbers section of the Portal.

Docs Images (1)

Step 5: Create an outbound voice profile (not required for Inbound)

To initiate an outbound fax, you must create an Outbound Voice Profile and assign your Programmable Fax Application to it.

Select "Outbound Voice Profiles" on the left-hand navigation menu, click "+Add New Profile" and set up your profile name. Add the Programmable Fax Application you just created above, the traffic type, the service plan, and your desired billing method.

You can also do this programmatically via our RESTful API. Check out our documentation for Outbound Voice Profiles.

That’s it. You're all set to start integrating Telnyx with your applications.

Where to next?

Head over to our tutorials to learn how to send a fax and receive a fax via API.

After you setup your development environment you can also dive deeper into sending commands and receiving webhooks.

On this page