Skip to main content

​
Telnyx Development: Account setup — Full Documentation

Complete page content for Account setup (Development section) of the Telnyx developer docs (https://developers.telnyx.com). Root index: https://developers.telnyx.com/llms.txt · Lightweight index for this subsection: https://developers.telnyx.com/development/llms/development-account-setup-llms-txt.md

​
Getting Started

​
Create Account

Source: https://developers.telnyx.com/docs/account-setup/create-account.md
Before you can start using any Telnyx services, you’ll need to create an account to access our APIs and Mission Control Portal.

​
Account creation steps

Navigate to telnyx.com/sign-up to start the signup process. Enter your contact information, company details, and a secure password. This ensures Telnyx can verify who you are. Look for the confirmation email and click the verification link so we know you’re the owner of the address you used. Access the Mission Control Portal with your new credentials to finish onboarding and explore your dashboard. New accounts come with free testing credits so you can explore the platform before adding payment methods.

​
Need help?

If you encounter any issues during account creation:

​
Account Signup

Source: https://developers.telnyx.com/docs/account-setup/signup.md
Every signup attempt is subjected to a battery of trust and safety checks. Among them, in no particular order, are the following:
  • Domain age
  • Domain reputation
  • Host reputation
  • IP reputation
  • Signup origin
  • reCAPTCHA verification
An attempt will be unsuccessful if any of the above fails. Some attempts may also be subjected to additional requirements, including:
  • Successfully validating a legitimate mobile number
  • Successfully passing Know Your Customer (KYC) documentation verification
Telnyx constantly adjusts the logic, sequence, and thresholds to combat signup abuse and fraudulent usage of the platform.

​
Account Levels Overview

Source: https://developers.telnyx.com/docs/account-setup/levels-and-capabilities.md
A successful signup may be placed in one of the following frameworks (but never both):
  • Level 1 / Level 2 account framework
  • Trial-Paid-Verified-Enterprise (TPVE) framework
An account is in the Level 1 / Level 2 framework when the verification page exists in the user’s Mission Control Portal account. The remainder of this account setup section is only relevant to an account in the TPVE framework. An account is in the TPVE framework when the Account Levels page exists in the user’s Mission Control Portal account. The level of an account is an organizational attribute. If the account is a paid account, all organization members have the privileges and limits of a paid account. For a holistic understanding of privileges and limits at each account level, consult the corresponding pages in this section, together with the following tables:
  • V2 APIs
  • S3 Compatible Storage APIs

​
Account Types & Capabilities

​
Trial Account

Source: https://developers.telnyx.com/docs/account-setup/levels-and-capabilities/trial.md

​
Testing credit

USD $5 in testing credit is provided.

​
Access

  • Full access except otherwise specified below.
  • Telnyx reserves the right to modify limitations without notification.

​
Numbers

​
Verified numbers

  • Limited to 1 verified number at any one time.
  • Limited to 10 changes per trial account lifetime.
  • Limited to 15 delivery attempts regardless of conversion outcome per trial account lifetime.

​
Number searching

  • Full number display limited to local numbers of the account’s country of origin.
  • All other numbers will be shown redacted (e.g., +49351xxxxxxx).
  • No access to other APIs or features in this category.

​
Number reservation

  • No access to APIs or features in this category.

​
Number ordering

  • Limited to 1 local number of the account’s country of origin per trial account lifetime.
  • Successful number activation is subject to inventory availability, sufficient account balance, and local jurisdiction documentation rules.
  • This number will be reclaimed within 30 days of purchase if the account has not upgraded.
  • No port out is allowed on this number.
  • No access to other APIs or features in this category.

​
Number porting

  • Limited to 50 portability check attempts per trial account lifetime.
  • No access to other APIs or features in this category.
  • Users do not have proprietary rights to their trial telephone number, and Telnyx reserves the right to make reasonable changes to them with reasonable notice. Users cannot port out their trial number.

​
Bundles

  • No access to APIs or features in this category.

​
Messaging

  • Limited to 1 messaging profile at any one time.
  • Outbound: Limited to long code sending, destination limited to verified number, and capped at 100 messages a day.
  • Inbound: Limited to receiving from the verified number.
  • No access to other APIs or features in this category.

​
Verify

  • Limited to 1 verified profile at any one time.
  • Only SMS is allowed.
  • Destination limited to verified number.
  • Limited to a max of 50 verifications a day.
  • No access to other APIs or features in this category.

​
Voice

​
General limits

  • Limited to 1 instance per connection type at any one time.
  • Limited to 1 outbound voice profile at any one time.
  • Outbound limited to dialing only the verified phone number.
  • Inbound limited to receiving from the verified phone number.
  • Limited to 2 concurrent outbound calls across all connection instances.
  • Limited to a maximum of 10 minutes per call.

​
Programmable Voice

  • All machine-generated voices are prepended with: “This is an automated call generated on the Telnyx platform, please report any abuse to fraud@telnyx.com”.
  • This applies to:
    • /v2/calls
    • /v2/calls/:call_control_id/actions/transfer
    • /v2/calls/:call_control_id/actions/gather_using_audio
    • /v2/calls/:call_control_id/actions/gather_using_speak
    • /v2/calls/:call_control_id/actions/playback_start
    • /v2/calls/:call_control_id/actions/speak
    • /v2/calls/:call_control_id/actions/gather_using_ai
    • /v2/calls/:call_control_id/actions/ai_assistant_start
    • TeXML verb Play
    • TeXML verb Say
    • TeXML verb AIGather
  • Limited to a maximum of 100 outbound calls a day.
  • Limited to 10 outbound calls per hour.

​
Microsoft Operator Connect

  • No access to APIs or features in this category.

​
Microsoft Direct Routing

  • No access to APIs or features in this category.

​
Zoom Phone Provider Exchange

  • No access to APIs or features in this category.

​
LRN / Number Lookup

  • No access to APIs or features in this category.

​
Cloud Storage

  • Limited to non-public policy or ACL on buckets or objects.
  • Limited to 5 minutes of TTL on pre-signed URLs.
  • Limited to the documented free tier of used capacity across all buckets and regions.

​
Wireless

  • No access to physical SIM registration.
  • No access to eSIM purchase.

​
Account features

​
Organizations and sub-users

  • No access to APIs or features in this category.

​
ManagED Accounts

  • No access to APIs or features in this category.

​
Payment methods

  • Limited to credit cards.

​
Billing groups

  • No access to APIs or features in this category.

​
API keys

  • Limited to 1 API key at any one time.
  • No access to other APIs or features in this category.

​
DDoS mitigation

  • No access to APIs or features in this category.

​
Using Your Trial Account

Source: https://developers.telnyx.com/docs/account-setup/using-trial-account.md
Follow this process to make the most of your trial credit and stay within trial limitations. A verified number is essential to test Voice and Messaging. Use a mobile phone number that you control. Keep in mind that trial accounts have limits on delivery attempts and the number of changes allowed. Once the allowance is depleted, upgrade your account. Search results show only local (to the signup origin) numbers in full +E164; other results appear partially redacted. A successful purchase depends on inventory availability, sufficient account balance, and local jurisdiction documentation rules. Only one phone number order is allowed during the trial, regardless of the outcome. Use one of the following tutorials to place calls: Regardless of how the call is created, the destination is limited to the verified phone number from Step 1, and inbound calls must also originate from that number. Check trial voice limits. Use the Send Message tutorial to send SMS. Outbound messages must target the verified phone number you configured, and inbound messages must also originate from that number. Check trial messaging limits.
Source: https://developers.telnyx.com/docs/account-setup/levels-and-capabilities/paid.md

​
Access

  • Full access except otherwise specified below.
  • Telnyx reserves the right to modify limitations without notification.

​
Numbers

​
Number searching

  • No access to number blocks.

​
Number ordering

  • Limited to local numbers whose country code matches the account’s country of origin.

​
Number porting

  • No access to LRN migration.

​
Messaging

  • No access to 10DLC.
  • No access to Toll-Free verification.
  • No access to hosted messaging.

​
Voice

​
General limits

  • Limited set of outbound destination country codes.
  • Limited to 5 concurrent outbound calls across all connection types.

​
Programmable Voice

  • All machine-generated voices are prepended with: “This is an automated call generated on the Telnyx platform, please report any abuse to fraud@telnyx.com”.
  • This applies to:
    • /v2/calls
    • /v2/calls/:call_control_id/actions/transfer
    • /v2/calls/:call_control_id/actions/gather_using_audio
    • /v2/calls/:call_control_id/actions/gather_using_speak
    • /v2/calls/:call_control_id/actions/playback_start
    • /v2/calls/:call_control_id/actions/speak
    • /v2/calls/:call_control_id/actions/gather_using_ai
    • /v2/calls/:call_control_id/actions/ai_assistant_start
    • TeXML verb Play
    • TeXML verb Say
    • TeXML verb AIGather
  • Limited to a maximum of 100 outbound calls a day.
  • Limited to 10 outbound calls per hour.

​
Cloud Storage

  • Limited to non-public policy or ACL on buckets or objects.
  • Limited to 5 minutes of TTL on pre-signed URLs.

​
Account features

​
ManagED Accounts

  • No access to APIs or features in this category.

​
Payment methods

  • Credit card
  • PayPal

​
DDoS mitigation

  • No access to APIs or features in this category.

​
Verified Account

Source: https://developers.telnyx.com/docs/account-setup/levels-and-capabilities/verified.md

​
Access

  • Full access except otherwise specified below.
  • Telnyx reserves the right to modify limitations without notification.

​
Numbers

​
Number searching

  • No access to number blocks.

​
Number ordering

  • No access to number blocks.

​
Number porting

  • No access to LRN migration.

​
Account features

​
ManagED Accounts

  • No access to APIs or features in this category.

​
Payment methods

  • Credit card
  • PayPal
  • BTC

​
DDoS mitigation

  • No access to APIs or features in this category.
Qualification by the Telnyx sales team is required to upgrade your account to the enterprise level to gain access to the above features. Contact Telnyx to start the process.

​
Account Management

​
Account Upgrade

Source: https://developers.telnyx.com/docs/account-setup/account-upgrade.md
Identify the desired account level and complete all required actions. For enterprise upgrades, qualification by the Telnyx sales team is required. Contact Telnyx to begin the process.

​
Data Locality

Source: https://developers.telnyx.com/docs/account-setup/data-locality.md
Data Locality lets you choose the geographic region where your Telnyx data is stored at rest.

​
Available regions

​
Covered data types

Data locality applies to the following data stored at rest:
  • Call Detail Records (CDRs)
  • Message Detail Records (MDRs)
  • Conference records
  • Forking CDRs
  • Media Storage (recordings)
  • Premium AMD
  • Speech-to-Text
  • Verify
  • Video
  • WhatsApp
  • Wireless

​
Selecting a region

  1. Log in to the Mission Control Portal.
  2. Go to Account settings > Profile.
  3. Scroll to Data Storage Location and select a country from the dropdown.
  4. Click Save Location.
This setting can only be changed once and cannot be undone. After you save, Telnyx migrates your data to the new location. Some features may become temporarily unavailable during migration — the process can take a few minutes to several hours depending on your data size. All existing accounts default to the US. If you do not change the setting, your data remains in the US.