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

Docs

Getting Started with your Mission Control Accountgetting-started-with-your-mission-control-account

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

Descriptiondescription

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.

Sign up for a Telnyx Accountsign-up-for-a-telnyx-account

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 by Step Guidestep-by-step-guide

1. Level 1 Verification1--level-1-verification

In order to assign a connection/messaging profile on a DID or a connection on an outbound profile, you'll need to be Level 1 verified. More information on account verification can be found hereTelnyx Developers.


2. Connection Setup2--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 Steps

  1. 1Navigate the 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 whitelist your your server to our sip.telnyx.comTelnyx Developers domain.

Option 1: Credentials Authentication

  1. 4Select "Credentials" as the "Connection Type".
  2. 5A 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. 6Click "Set Credentials".
  4. 7Click "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.

Option 2: IP Authentication

  1. 4Select "IP Address" as the "Connection Type".
  2. 5Enter 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. 6Click "Add IP".
  4. 7Click "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 Authentication

  1. 4Select "FQDN" as the "Connection Type".
  2. 5Enter your fully qualified domain name in the "INBOUND" section and click "Add FQDN".
  3. 6In 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. 7Click "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 NumbersAPI.


3. DIDs3--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.


4. Outbound Profile4--outbound-profile

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

You can also do this programmatically via our RESTful API. Check out our documentation for Outbound 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!