This is the current API V1 documentation. Explore our API V2 if you’d like to test new features.

Open SidemenuDocs
Close Sidemenu

How to configure a 3CX PBX Version 16 Credentials Trunkhow-to-configure-a-3cx-pbx-version-16-credentials-trunk

How to configure a 3CX PBX Credentials Trunk Version 16


3CXTelnyx Developers is an open standards IP PBX that offers complete Unified Communications, out of the box. Suitable for any business size or industry 3CX can accommodate to your every need; from mobility and status to advanced contact center features and more, at a fraction of the cost.

3CX makes installation, management and maintenance of your PBX so easy that you can effortlessly manage it yourself, whether on an appliance or server at your premise or in the cloud. This article guides you on how to configure this PBX for making and receiving calls over the internet through a next generation carrier like Telnyx!

You'll need to have created a credentials based connection on your Telnyx Mission Control Portal account, assigned this connection to a DID and outbound profile in order to make and receive calls.

Note - You'll need to acquire a license when installing this version of 3CX. You'll be prompted to fill out a form and include your email address so they can verify your email and send you the license key.



3CX Version 16 is available to download from hereTelnyx Developers.


You can view the installation guide hereTelnyx Developers.

Video Walkthrough

Coming soon! This walkthrough will demonstrate setting up a Credential based connection with 3CX. We'll also show you how to assign this connection to a newly purchased DID which will allow you to receive inbound calls. Then we'll walk you through how to assign the connection to an outbound profile such that you can make outbound calls!

Configuring Your Telnyx Mission Control Portalconfiguring-your-telnyx-mission-control-portal

For step by step instructions on each of the requirements on the Telnyx Mission Control Portal, please follow this guide.

Once you've configured your Telnyx account, you can now proceed to setup 3CX following the guide below.

3CX Setup Guide3cx-setup-guide


During the installation process, 3CX will ask you to specify a username and password which will be used to login to the web interface. 3CX automatically detect your pubic IP address. You can then specify if this is a static or dynamic IP. You can configure your 3CX with an FQDN and 3CX will provide you with one - they do this to ensure your FQDN is set to resolve to your Public IP and for generating certificates. You'll then choose your default network adapter and decide whether you want the extensions to use the local IP of your PBX or the FQDN you created. At the end, you'll choose your preferred http/https port numbers which will be used to allow you to access the 3CX web interface via your FQDN or Public IP.

Great you can now login and begin your configuration!

Basic Setup


Specify Extension Length


Specify an Admin Email

Specify an admin email and configure your mail server configuration by specifying a mail provider.


Select Country and Time Zone


Specify a Default Operator Extension


Security - Confirm Countries Calls Can Be Made To


Select a Language

The last sub section is registration and you should fill out your personal details here. 3CX

3CX PBX CONFIGURATION3cx-pbx-configuration

Confirm Your Network Settings

  • Go to "Settings" -> "Network"
  • "Ports" Tab: make sure your "SIP Port" is set to 5060.
  • "Public IP" Tab: double check your Public IP is correct and that you have selected the proper Network card Interface.
  • Settings --> Click on "Network Settings" --> Public IP tab --> Section : "External IP Configuration".

    Note - Please make sure that connection IP on the portal and Static Public IP is same.

Create Telnyx SIP Trunk

  1. 1Click on "SIP Trunks" from the navigation menu on the left.
  2. 2Click "+ Add SIP Trunk" near the top of the screen.
  3. 3A new pop up will be opened. You need to enter/select all the required details:
    • Select Country: Worldwide
    • Select Provider in your Country: Telnyx LLC
    • Main Trunk No: Enter the number which you have purchased on your Telnyx Mission Control Portal


  1. 4After entering the details, Click on OK
  2. 5This will open the trunk configuration window:
    • Tabs
    • General
    • DIDs
    • Caller ID
    • Inbound Parameters
    • Outbound Parameters
  3. 6In the General tab, there are 3 sections to be explained in the following sections:
    • Trunk Details
    • Authentication
    • Route calls to

Trunk Details

  • Enter name of Trunk: Telnyx LLC
  • Registrar/Server/Gateway Hostname or IP: or
  • Outbound Proxy:
  • Number of SIM Calls: set your preferred amount of simultaneous calls



  • Type of Authentication: Register/Account based.
  • Authentication ID (aka SIP user ID): You need to use the username from the connection which you have created in the Telnyx portal.
  • Authentication Password: You need to use password from the connection which you have created in the Telnyx portal.


Route calls to

  • Main Trunk number: By default number will be shown. You need cross verify with the number which you have purchased on telnyx portal.
  • Destination for calls during the office hours: Based on your requirement.
  • Destination for calls outside the office hours: Based on your requirement.


  1. 7Select the "Options" tab
    • For "Require registration for:" select "Do not require".
    • Remove the "GSM-FR" from Assigned Codecs.
    • Click "Apply".
  2. 8Select the "Outbound Parameters"
    • For "Contact : User Part" in the SIP Field column Select "Custom Field".
    • To allow private calling - "From: Display Name" and "From : User Part", select "Custom Field" but leave the Custom values blank.
    • Click "Apply".


  1. 9After entering all the details please click on “OK” which is on the top.
    • If all the fields are entered correctly the IP trunk will now be live. We can now proceed to our inbound and outbound rules.


Inbound Rules

  • Click on "Inbound Rules" from the navigation menu on the left.
  • Click on "+Add DID Rule" near the top of the screen.
  • There are 2 sections in this:
    • General
    • Route calls to



Route Calls to


Outbound Rules:

  • Click on "Outbound Rules" from the navigation menu on the left.
  • Click on "+Add" near the top of the screen.
  • There are 3 sections in this :
    • General
    • Apply this rule to these calls
    • Make outbound calls on


Rule Name : You can enter any preferred name


Apply this rule to these calls:

  • Calls to numbers starting with prefix : leave empty.
  • Calls from extension(s) : You need to give the extension numbers.
  • Note: ‘000’ is the extension used as an example.
  • Calls to Numbers with a length of : leave empty.


Make outbound calls on:

We need to configure routes in this section. Configure up to 3 routes for calls. The second and third route will be used as backup. For each route, digits can be stripped or added. Strip Digits 0 on Route 1 and Strip Digits 1 digit for remaining 2 routes.


After completing the configuration, click "OK".

That's it, you've now completed the configuration of 3CX V16 IP-PBX Trunk and can now make and receive calls by using Telnyx as your SIP provider!

Additional Resourcesadditional-resources

Review our getting started guide to make sure your Telnyx Mission Control Portal account is setup correctly.

Checkout 3CX's help sectionTelnyx Developers for extra support.

Can't find what you're looking for?can-t-find-what-you-re-looking-for-

Our knowledge base is currently undergoing a makeover which will include more up to date videos to match our ever growing platform.

Can't find what you're looking for? Click the Live Chat icon at your lower right hand corner and start a chat.