> ## Documentation Index
> Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Account setup llms-full.txt

> Complete machine-readable documentation content for Account setup (Development) for AI agents and LLMs

# Telnyx Development: Account setup — Full Documentation

> Complete page content for Account setup (Development section) of the Telnyx developer docs ([https://developers.telnyx.com](https://developers.telnyx.com)).
> Root index: [https://developers.telnyx.com/llms.txt](https://developers.telnyx.com/llms.txt) · Lightweight index for this subsection: [https://developers.telnyx.com/development/llms/development-account-setup-llms-txt.md](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](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](https://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](https://portal.telnyx.com) 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:

* Review the [Account Setup FAQ](https://support.telnyx.com)
* Contact our support team through the Mission Control Portal
* Join the [Telnyx Slack community](https://joinslack.telnyx.com) for developer support

***

### Account Signup

> Source: [https://developers.telnyx.com/docs/account-setup/signup.md](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](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](https://portal.telnyx.com/#/account/my-account/verifications) 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](https://portal.telnyx.com/#/account/account-levels) 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](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](mailto: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](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](https://portal.telnyx.com/#/numbers/verified-numbers) 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](/docs/account-setup/account-upgrade).

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](https://portal.telnyx.com/#/numbers/requirements). Only **one** phone number order is allowed during the trial, regardless of the outcome.

Use one of the following tutorials to place calls:

* [SIP Trunking](https://developers.telnyx.com/docs/voice/sip-trunking/get-started)
* [Programmable Voice](https://developers.telnyx.com/docs/voice/programmable-voice/get-started)
* [TeXML](https://developers.telnyx.com/docs/voice/programmable-voice/texml-setup)

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](/docs/account-setup/levels-and-capabilities/trial).

Use the [Send Message](https://developers.telnyx.com/docs/messaging/messages/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](/docs/account-setup/levels-and-capabilities/trial).

***

### Paid Account

> Source: [https://developers.telnyx.com/docs/account-setup/levels-and-capabilities/paid.md](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](mailto: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](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](https://telnyx.com/contact-us) to start the process.

***

## Account Management

### Account Upgrade

> Source: [https://developers.telnyx.com/docs/account-setup/account-upgrade.md](https://developers.telnyx.com/docs/account-setup/account-upgrade.md)

| Criteria to meet                  | Trial | Paid | Verified |
| --------------------------------- | :---: | :--: | :------: |
| Verified email                    |   X   |   X  |     X    |
| Verified mobile number            |       |   X  |     X    |
| Made a payment with CC/Debit Card |       |   X  |     X    |
| Enabled 2FA for the account       |       |   X  |     X    |
| Provided Service Address          |       |   X  |     X    |
| Successfully passed KYC           |       |      |     X    |
| Successfully passed AI agent eval |       |      |     X    |

Identify the desired account level and complete **all** [required actions](https://portal.telnyx.com/#/account/account-levels). For enterprise upgrades, qualification by the Telnyx sales team is required. [Contact Telnyx](https://telnyx.com/contact-us) to begin the process.

***

### Data Locality

> Source: [https://developers.telnyx.com/docs/account-setup/data-locality.md](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

| Region | Location      | Default |
| :----- | :------------ | :------ |
| US     | United States | Yes     |
| EU     | Germany       | No      |
| APAC   | Australia     | No      |

***

## 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](https://portal.telnyx.com).
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.

***
