This is the API V2 documentation. To switch out of beta revert back to our API V1.

Open SidemenuDocs
Docs
Close Sidemenu

Portal Setupportal-setup

In this guide, you’ll learn how to get started with your Mission Control account after sign up.

This article lists four requirements needed to set up your Telnyx Mission Control Portal account so that it's ready to be configured to your PBX phone system, softphone client, or softswitch of your choice.

Before you get started, you will need to set up a Mission Control Portal account. To do this, head to telnyx.com/sign-upTelnyx Developers to sign up for your free Telnyx account. It’ll give you access to our Mission Control Portal, where you can buy numbers, set up and manage messaging profiles and more.


Step 1: Level 1 Verificationstep-1--level-1-verification

In order to assign a Connection/Messaging Profile to a DID or a connection to an Outbound Voice Profile, you'll need to be Level 1 verified. More information on account verification can be found hereTelnyx Developers.

Step 2: Connection Setupstep-2--connection-setup

A connection is needed to authenticate your client with our SIP proxy (sip.telnyx.com). We have three authentication options on the portal: Credentials, IP Address & FQDN.

Initial Stepsinitial-steps

  1. 1Navigate to the Connections page of the Mission Control Portal.
  2. 2Click the "+ Add Connection" button near the top right corner of the page.
  3. 3Enter the name you wish to have for your Connection.

You must then select one of the authentication methods that you wish to use to whitelist your server to our sip.telnyx.comTelnyx Developers domain.

Option 1: Credentials Authenticationoption-1--credentials-authentication

  1. 1Select "Credentials" as the "Connection Type".
  2. 2A username and password will automatically be generated but you change the credentials by clicking the "edit" button to the left. Please make sure you use strong credentials.
  3. 3Click "Set Credentials".
  4. 4Click "Done".

    Note - Once your Credential Connection is created, you can display the username and password by clicking the eye icon under the "Auth Detail" column.

Credential Connection Settings

Option 2: IP Authenticationoption-2--ip-authentication

  1. 1Select "IP Address" as the "Connection Type".
  2. 2Enter the IP address that your switch is behind - You can specify the port number by entering in your port number after the IP address with a colon in between. Example: 192.76.120.10:5060
  3. 3Click "Add IP".
  4. 4Click "Done".

    Note - You can assign multiple IP addresses to a single IP registered Connection. You can set the routing priority and routing method implemented on the Connection.

Option 3: FQDN Authenticationoption-3--fqdn-authentication

  1. 1Select "FQDN" as the "Connection Type".
  2. 2Enter your fully qualified domain name in the "INBOUND" section and click "Add FQDN".
  3. 3In the "OUTBOUND" section, you can pick between Credential or IP authentication. Once the credential details or IP address has been entered select "Set Credentials" or "Add IP" depending on which authentication method you selected.
  4. 4Click "Done".

    Note - You can assign multiple FQDN addresses on the Inbound section and multiple IP addresses on the Outbound section to a single FQDN registered Connection. You can set the routing priority and routing method implemented on the Connection.

More details on the Connection authentication types and how to set it up can be found hereTelnyx Developers.

You can also do this programmatically via our RESTful API. Check out our documentation for ConnectionsAPI.

Step 3: DIDsstep-3--dids

A DID is required in order to receive inbound calls to your client. Once you have purchased a DID on your account, you'll have to assign the Connection you wish to receive inbound calls to. More details on our number search feature can be found hereTelnyx Developers. Information on assigning DIDs to a connection and DID features can be found hereTelnyx Developers.

You can also do this programmatically via our RESTful API. Check out our documentation for NumbersAPI.

Step 4: Outbound Voice Profilestep-4--outbound-voice-profile

An Outbound Voice Profile is required in order to make outbound calls. More information on creating an Outbound Voice Profile and its features are explained hereTelnyx Developers.

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

Additional information that may be needed for configuring your client, such as a list of our signalling and media IP's, to our SIP proxy, can be found at sip.telnyx.comTelnyx Developers.


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!

Click the chat bubble at your lower right hand corner and start a chat!

Was this page helpful?was-this-page-helpful