API error codes - Telnyx

This page lists the general Telnyx API error codes. Product-specific delivery, protocol, SDK, and provider errors are maintained in their product references and combined with this table in the unified catalog.

Unified machine-readable error catalog: normalized entries with product scope, source provenance, and authored remediation metadata.
Catalog source registry: versioned inventory of the maintained public tables included by the generator.

Product-specific references

General API error codes

Code	Title	Detail
10001	Inactive phone number	The phone number is inactive.
10002	Invalid phone number	The phone number is invalid.
10003	Invalid URL	The URL provided was invalid, malformed, or too long. URLs can be a maximum of 2000 characters.
10004	Missing required parameter	A required parameter was missing.
10005	Resource not found	The requested resource or URL could not be found.
10006	Invalid ID	The resource ID provided was invalid.
10007	Unexpected error	An unexpected error occured.
10008	Request timeout	The request timed out.
10009	Authentication failed	The required authentication headers were either invalid or not included in the request.
10010	Authorization failed	You do not have permission to perform the requested action on the specified resource or resources.
10011	Too many requests	You have exceeded the maximum number of allowed requests.
10012	Duplicate resource	Resource is a duplicate.
10013	Missing association	One of the associated fields does not exist.
10014	Unsupported Media Type	The request failed because the server does not support the media type.
10015	Bad Request	The request failed because it was not well-formed.
10016	Phone number must be in +E.164 format	The specified phone number parameter must be in +E.164 format.
10017	Associated resource does not exist	The requested parameter is invalid as the associated resource does not exist.
10018	Invalid sort direction	The ‘sort_direction’ parameter must have a value of either ‘asc’ or ‘desc’.
10019	Invalid email address	The ‘email’ parameter is not a valid email address.
10020	Invalid resource type	The requested parameter must be of type ‘string’
10021	Resource in use	The resource can not be removed as it is still in use.
10022	One or more invalid IDs	One or more of the IDs provided were invalid.
10023	Invalid JSON	The supplied JSON is invalid.
10024	Unsupported Content-Type	Must encode request as ‘application/x-www-form-urlencoded’ or ‘application/json’
10025	String length out of range	The string length provided for the indicated field was outside the allowed range. The field must be between and characters long, but was .
10026	Invalid parameter type	The parameter must be of type , but received type
10027	Unprocessable Entity	The server understood the syntax of the request but was unable to process the instructions.
10028	Character encoding error	The request body was not able to be decoded.
10029	Expected JSON Content-Type	Must encode request as ‘application/json’
10030	Method not allowed	The URL is valid, but the method is not allowed.
10031	Invalid request filter	The request filter filter[] is invalid.
10032	Invalid enumerated value	The value must be one of
10033	Value outside of range	The value is outside of allowed range to
10034	Expected URL-encoded form Content-Type	Must encode request as ‘application/x-www-form-urlencoded’
10035	Resource locked	The resource has been locked. Contact Telnyx support.
10036	Resource is being processed	This resource is in ongoing processing and it can’t be interacted with. Please, wait for its operation to finish and retry later.
10037	Service unavailable	Service is unavailable.
10038	Feature not permitted	This feature is not permitted at this account level. Refer to https://telnyx.com/upgrade.
10039	Feature limited	A limit for this feature has been reached at this account level. See https://telnyx.com/upgrade for options.
10700	Invalid caller data	The CNAM caller data provided is invalid.
20000	Invalid resource groups	The resource groups provided are invalid.
20001	Invalid API Key secret	The secret provided is invalid.
20002	API Key revoked	The API Key provided is not active.
20003	API Key forbidden	The API Key provided is forbidden.
20004	Invalid permission groups	The permission groups provided are invalid.
20005	Invalid user	The user provided is invalid.
20006	Expired access token	The access token provided is expired.
20007	Invalid permission groups	The permission groups provided must be a subset of the API Key’s.
20008	Invalid API Key	The API Key provided is invalid.
20009	Invalid user	The user provided does not exist.
20010	Invalid invitation	The invitation provided does not exist.
20011	API Key in use	The API Key can not be revoked while assigned to a portal user.
20012	Account inactive	The request cannot be fulfilled because your account has been deactivated. It may be out of funds.
20013	Account blocked	Your account has been blocked. Please contact Telnyx support.
20014	Account unverified	You have not completed the verifications required to perform this action. Check the ‘verifications’ tab under ‘account’ on the portal for more information.
20015	Feature not enabled	The feature is not enabled on your account.
20016	Account not level 1 verified	Level 1 account verification is required to perform this action. Check the ‘verifications’ tab under ‘account’ on the portal for more information.
20017	Account not level 2 verified	Level 2 account verification is required to perform this action. Check the ‘verifications’ tab under ‘account’ on the portal for more information.
20100	Insufficient Funds	You do not have enough funds to perform this action.
20200	Invalid address	The address provided is invalid.
20201	Invalid country code	The country code provided is invalid.
20202	Invalid locality	The locality provided is invalid.
20203	Invalid neighborhood	The neighborhood provided is invalid.
20204	Invalid administrative area	The administrative area provided is invalid.
20205	Invalid postal code	The postal code provided is invalid.
20206	Invalid borough	The borough provided is invalid.
20207	Invalid street address	The street address provided is invalid.
20208	Invalid street address house number	The street address house number provided is invalid.
20209	Invalid extended address	The extended address provided is invalid.
40001	Not routable	The destination number is either a landline or a non-routable wireless number.
40002	Blocked as spam - temporary	The message was flagged by a SPAM filter and was not delivered. This is a temporary condition.
40003	Blocked as spam - permanent	The message was flagged by a SPAM filter and was not delivered. The originating phone number is permanently blocked.
40004	Rejected by destination	The recipient server is rejecting the message for an unknown reason.
40005	Message expired during transmission	The message expired before it could be fully delivered to the recipient.
40006	Recipient server unavailable	The recipient server is unavailable or not responding.
40007	Loop detected	Infinite loop detected.
40008	Undeliverable	The recipient carrier did not accept the message.
40009	Invalid message body	The message body was invalid.
40010	Not 10DLC registered	The sending number is not 10DLC-registered but is required to be by the carrier.
40011	Too many requests	Exceeded upstream rate limit. As a result the message was flagged by a SPAM filter and was not delivered. This is a temporary condition.
40012	Invalid messaging destination number	The destination phone number was deemed invalid by the carrier.
40013	Invalid messaging source number	The source phone number was deemed invalid by the carrier.
40014	Message expired in queue	The message was not sent by Telnyx because its validity period expired.
40015	Blocked as spam - internal	The message was flagged by an internal Telnyx SPAM filter.
40016	T-Mobile 10DLC Sending Limit Reached	You have exceeded T-Mobile’s allotted throughput limits for the campaign associated to this phone number
40017	AT&T 10DLC Spam Message Rejected	AT&T has rejected your message for spam on the 10DLC route
40018	AT&T 10DLC Sending Limit Reached	You have exceeded AT&T’s allotted throughput limits for the campaign associated to this phone number
40019	AT&T 10DLC Invalid Tag Data	AT&T has rejected your message because the tagging information is incorrect
40020	Blocked as potentially artificial inflation of traffic	Sending of 2FA traffic has been blocked for 24 hours.
40100	Number not messaging enabled.	The number is not currently messaging enabled.
40150	Toll free number not in registry	Messaging cannot be enabled for this number because the number is not in the voice registry.
40151	Message enablement pending with other provider	Messaging is in the process of being enabled with another messaging provider.
40152	Invalid OSR parameter	One of the parameters sent to the OSR was missing or invalid.
40153	Cannot access OSR	Telnyx is not authorized to access the OSR.
40154	Unauthorized NNID	Telnyx is not authorized to use this NNID.
40155	LOA required	An LOA is required to text message enable this number.
40156	Unauthorized property name/value	Telnyx is not authorized to provision this property name or property value.
40157	Temporarily blocked	Telnyx is temporarily unable to make changes to the OSR.
40158	Delete failed	The record was not found or the NNID was invalid so it could not be deleted.
40159	Unknown OSR error	An error occurred while updating the OSR.
40300	Blocked due to STOP message	Messages cannot be sent from to due to an existing block rule.
40301	Unsupported message type for the ‘to’ address	Sending messages from to is currently unsupported.
40302	Message too large	The SMS message would be divided into parts. The maximum is .
40303	Message not found	The message with ID was not found.
40304	Invalid combination of message content arguments	The message must contain exclusively ‘body’ for SMS, or ‘subject’ and/or ‘media_urls’ for MMS
40305	Invalid ‘from’ address	The ‘from’ address should be string containing a valid phone number or alphanumeric sender ID associated with the sending messaging profile.
40306	Alpha sender not configured	The messaging profile doesn’t have an associated alphanumeric sender ID.
40307	Alpha sender mismatch	The specified alphanumeric sender ID does not match the one configured on the profile
40308	Invalid ‘from’ address for MMS	MMS can only be sent from US long code numbers and MMS-configured short codes
40309	Invalid destination region	The region for the destination is not included in the messaging profile’s whitelisted destinations.
40310	Invalid ‘to’ address	The ‘to’ address should be a single valid number.
40311	Invalid messaging profile secret	The provided X-Profile-Secret header was invalid.
40312	Messaging profile is disabled	The specified messaging profile is disabled.
40313	Missing messaging profile secret	The X-Profile-Secret header is missing.
40314	Messaging disabled on account	Messaging has been disabled on your account. Contact Telnyx support.
40315	Unhealthy ‘from’ address	Sending number (with success rate and spam rejection rate ) did not pass the health check.
40316	No content provided for message	The message has no content. Either ‘text’ and/or ‘media_urls’ must be provided in the request.
40317	Invalid MMS content	MMS can only contain up to 10 items (URLs provided) and the total size must be less than 1 MB.
40318	Message queue full	Message queue is full. Wait before resending.
40319	Incompatible message type for the ‘to’ address	Sending messages from to is not possible.
40320	Temporarily unusable ‘from’ address	The sending number is in a temporarily unusable or pending state.
40321	No usable numbers on messaging profile	Number Pool is not enabled, or it is unable to select a usable number on the messaging profile.
40322	Blocked due to content	Message contains invalid content.
40323	Messaging activation failed	Could not enable messaging on the number.
40324	Messaging product type change failed	Could not change product types for the number.
40325	Invalid alphanumeric sender ID	The specified alphanumeric sender ID value is invalid.
40326	Cannot assign alphanumeric sender ID	The alphanumeric sender ID could not be assigned to the messaging profile.
40327	Invalid Domain	The domain provided is not listed as a valid domain to be used with URL Shortener
40328	SMS exceeds recommended size	The SMS message would be divided into parts. Messages over should be sent by MMS or by adding auto_detect=False.
40329	Tollfree number is not verified	Try verifying the number if you haven’t already; otherwise double check that verification succeeded.
40330	Tollfree number is not provisioned	This TFN is not yet fully provisioned for messaging.
40331	Missing whitelisted destinations	Messaging profile is missing whitelisted destinations.
40332	Brand cannot be deleted	Brand cannot be deleted due to an associated active campaign.
40333	Messaging profile spend limit reached	Request refused because this would incur cost above the spend limit configured on the messaging profile.
41000	WhatsApp Error	-
50000	VRF still deployed	The VRF can not be removed as it is still deployed to one or more sites
50001	VRF not deployed	The VRF is not deployed at this site
50002	VRF already deployed	The VRF is already deployed at this site
50003	Invalid IP address	This is not a valid IP address
50004	Private IP address not permitted	Private IP addresses are not permitted
50005	Invalid CIDR block	This is not a valid CIDR block
50006	Private CIDR block not permitted	Private CIDR blocks are not permitted
50007	CIDR block too large	CIDR blocks are limited to / and higher
50008	Can not delete IP from source	Can not delete IP from source
55001	Credential expired, can not create token.	The credential used to create the token has expired.
65001	Invalid Room ID	The provided room_id was not valid.
70000	Consumption reached data limit	The consumption reached the defined data limit. Please, update the SIM card group data limit.
70001	There aren’t enough available SIM cards	Insufficient inventory to satisfy order request.
70002	Invalid data format	The provided data attribute was invalid.
70003	Mobile operators’ preferences priorities are out of sequence	The mobile operators’ preferences priorities should be in an ascending order starting by 0.
70004	OTA update in progress	SIM card network preferences can’t be defined when a previous OTA update is still in progress.
70005	Could not delete SIM card group	The SIM card group associated with the provided ID can not be deleted because there are SIM cards associated with the SIM card group.
70006	Could not delete default SIM card group	The SIM card group associated with the provided ID can not be deleted because it is the default SIM card group on your account.
70007	SIM card doesn’t have a SIM card group	A SIM card cannot be enabled unless it’s associated with a SIM card group.
70008	Public IPs are unavailable at this time	There aren’t any public IPs available at this time. Please contact Telnyx support for more information.
75000	Webhook delivery error	The webhook was not successful
75001	Could not resolve name	Unable to resolve the webhook URL domain name
75002	Could not connect to host	Could not connect to the webhook host
75003	Certificate misconfiguration	Webhook host certificate could not be verified
75004	Expired certificate	The webhook host certificate has expired
75005	Certificate name mismatch	The domain name on the certificate does not match the domain in the URL
75006	Untrusted certificate root	The certificate is not signed by a trusted authority
75299	Webhook host returned a non-200 HTTP 2XX	The server returned an HTTP 2XX code, but was not the expected HTTP 200
75300	Webhook host returned HTTP 3XX	The server returned an HTTP 3XX redirect
75400	Webhook host returned HTTP 400	The server returned an HTTP 400
75404	Webhook host returned HTTP 404	The server returned an HTTP 404
75499	Webhook host returned HTTP 4XX	The server returned an HTTP 4XX error
75500	Webhook host returned HTTP 500	The server returned an HTTP 500
75599	Webhook host returned HTTP 5XX	The server returned an HTTP 5XX error
80000	Wrong account	One or more numbers you are attempting to port do not belong to the specified account.
80001	Inactive number	One or more numbers you are attempting to port are not active on the account. Only active numbers may be ported.
80002	Wrong provider	Telnyx is not the service provider for one or more of the numbers you are attempting to port.
80003	Pending order	One or more numbers are already part of another port request.
80004	Invalid desired due date	The desired due date is not within the allowable window. Please review the porting guidelines.
80005	Invalid passcode or pin	The passcode or PIN provided does not match what has been assigned to the number.
80006	Invalid PON	The Purchase Order Number (PON) provided is invalid. It must be between 3 and 20 characters and may not contain special characters.
80007	FOC expired	The firm order committment has expired since the number was not ported on the agreed upon due date.
80008	Missing LOA	A valid LOA (Letter of Authorization) is required to port numbers.
80009	Illegible LOA	The LOA (Letter of Authorization) provided was illegible or unable to be viewed.
80010	Expired LOA	The LOA (Letter of Authorization) provided has expired and is no longer valid.
80011	Invalid SPID	The service provider ID (SPID) provided was not recognized.
80012	Unsuported carrier	The functionality requested is not supported with the specified carrier.
80013	Invalid country	Automated porting is only supported in the US and Canada.
80014	Service address mismatch	The service address provided does not match the address on the account.
80015	Stranded phone numbers	The BTN/ATN on the account is being ported out which would leave stranded any remaining phone numbers.
80016	No CSR data available	A CSR could not be retrieved because the data submitted did not match closely enough with the data on file with the carrier.
80017	Invalid service provider type	The ‘service_provider_type’ parameter must be one of either ‘Telnyx’ or ‘Peerless’.
80018	Invalid FOC date	The ‘foc_date’ parameter must be an ISO8601 datetime selected from the available FOC dates.
80019	Invalid service provider ID	The ‘service_provider_id’ parameter must be the ID of an existing service provider.
80020	Invalid subscription status	The ‘subscription_status’ parameter is required and must have a value of ‘pending’, ‘concurred’, ‘timer_expired’, ‘conflict’, ‘activated’, ‘cancel_pending’, ‘cancelled’, ‘disconnect_pending’, ‘disconnected’ or ‘failed’
80021	Invalid porting option	The ‘porting_option’ parameter is required and must have a value of ‘full’ or ‘partial’.
80022	Invalid document type	The ‘document_type’ parameter must have value of ‘loa’, ‘csr’, ‘invoice’ or ‘other’.
80023	Invalid value for rate centers	The ‘rate_centers’ parameter must be a list of valid rate centers.
80024	Record could not be deleted	The sub_request could not be deleted as it has associated phone_numbers.
80100	Subscription version not created	The new service provider did not create an NPAC subscription version.
80101	Subscription version does not match	The new service provider created an NPAC subscription version that does not match the record Telnyx created.
80200	Duplicate phone numbers found	Duplicate phone numbers were found in the request.
80201	Phone number limit exceeded	Too many phone numbers were specified for an LSR preorder.
80400	Invalid credentials	The Port PS account credentials were invalid.
80401	Too many phone numbers	There is a maximum of 1000 lookups per request.
85000	Must search phone number via search API first	You must search for the number through our API before attempting to purchase.
85001	Phone numbers not available	The numbers you are trying to order are no longer available for purchase.
85002	Phone numbers update not allowed on this order	You are trying to update a number that is not in this order.
85003	Regulatory requirements already satisfied	Regulatory requirements cannot be updated once all have been satisfied.
85004	Invalid connection id provided	The connection id provided is invalid.
85005	Invalid messaging profile id provided	The messaging profile id provided is invalid.
85006	The phone number is already reserved	The phone number is already reserved.
85007	Reservation limit exceeded	You have too many active phone number reservations.
85008	Reservation extension limit exceeded	The reservation has reached its limit of allowed extensions.
90000	Invalid value for format	Format must be of type ‘string’ with a value of either ‘mp3’ or ‘wav’.
90001	Invalid value for channels	Channels must be a ‘string’ with a value of either ‘single’ or ‘dual’.
90002	Invalid value for timeout	The ‘timeout’ parameter must be an ‘integer’ with a minimum and a maximum value accepted by command
90003	Invalid value for inter_digit_timeout	The ‘inter_digit_timeout’ parameter must be an ‘integer’ with a minimum value of 1 and a maximum value of 120000.
90004	Invalid value for min	The ‘min’ parameter must be an ‘integer’ with a minimum value of 1 and a maximum value of 128.
90005	Invalid value for max	The ‘max’ parameter must be an ‘integer’ with a minimum value of 1 and a maximum value of 128.
90006	Invalid value for tries	The ‘tries’ parameter must be an ‘integer’ with a minimum value of 1 and a maximum value of 128.
90007	Invalid value for terminating_digit	The ‘terminating_digit’ parameter must be a ‘string’ with a value of 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, *, or #.
90008	Invalid value for valid_digits	The ‘valid_digits’ parameter must be a ‘string’ with a value of 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, *, or #.
90009	Invalid value for loop	The ‘loop’ parameter must either be ‘infinity’ or an ‘integer’ with a minimum value of 1 and a maximum value of 100.
90010	Invalid value for payload	The ‘payload’ parameter should contain between 1 and 5000 characters.
90011	Invalid value for payload_type	The ‘payload_type’ parameter must be of type ‘string’ with a value of either text or ssml.
90012	Invalid value for voice	The ‘voice’ parameter must be ‘female’ or ‘male’ when using the en-US language.
90013	Invalid value for language	The ‘language’ parameter must be of type ‘string’ with a value of either de-DE, en-AU, en-GB, en-US, es-ES, fr-CA, fr-FR, it-IT, ja-JP, ko-KR, nl-NL, pt-BR, sv-SE or tr-TR.
90014	Invalid value for digits	The ‘digits’ parameter must be a ‘string’ made of a combination of either 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, A, B, C, D, w, W, * or #.
90015	Invalid Call Control ID	The provided call_control_id was not valid.
90016	Invalid value for stop	The ‘stop’ parameter must be a ‘string’ with a value of ‘all’, ‘current’ or ‘overlay’.
90017	Invalid value for client_state	The ‘client_state’ parameter must be a valid base64 string.
90018	Call has already ended	This call is no longer active and can’t receive commands.
90019	Conference has already ended	This conference is no longer active and can’t receive commands.
90020	Call recording triggered before audio started	Call recording cannot be started until audio has commenced on the call.
90021	Invalid value for duration	The ‘duration’ parameter must be an ‘integer’ with a minimum value of 100 and a maximum value of 500.
90022	Invalid value for minimum_digits	The ‘minimum_digits’ parameter must be an ‘integer’ with a minimum value of 1 and a maximum value of 128.
90023	Invalid value for maximum_digits	The ‘maximum_digits’ parameter must be an ‘integer’ with a minimum value of 1 and a maximum value of 128.
90024	Invalid value for maximum_tries	The ‘maximum_tries’ parameter must be an ‘integer’ with a minimum value of 1 and a maximum value of 128.
90025	Invalid value for timeout_millis	The ‘timeout_millis’ parameter must be an ‘integer’ with a minimum and a maximum value accepted by command
90026	Invalid value for inter_digit_timeout_millis	The ‘inter_digit_timeout_millis’ parameter must be an ‘integer’ with a minimum value of 1 and a maximum value of 120000.
90027	Invalid value for duration_millis	The ‘duration_millis’ parameter must be an ‘integer’ with a minimum value of 100 and a maximum value of 500.
90028	Invalid value for timeout_secs	The ‘timeout_secs’ parameter must be an ‘integer’ with a minimum and a maximum value accepted by command
90029	Invalid value for time_limit_secs	The ‘time_limit_secs’ parameter must be an ‘integer’ with a minimum value of 60 and a maximum value of 14,000.
90030	Invalid value for service_level	The ‘service_level’ parameter must be of type ‘string’ with a value of either ‘basic’ or ‘premium’.
90031	Call is not currently forked	Can’t stop forking, because the call isn’t currently forked.
90032	Too many conference participants	The participant is unable to join because the maximum number of participants () has been reached.
90033	Conference has no active participants	This conference does not have any active participants.
90034	Call has not been answered yet	This call can’t receive this command because it has not been answered yet.
90035	Call not in queue	This call can’t receive this command because it has not been put in any queue yet.
90036	Queue full	The queue is full and can’t accept more calls.
90037	Queue max_size cannot be modified	Queue exists and max_size cannot be modified.
90038	Call already in queue	Call can’t be added to a queue it’s already in.
90040	Downloading audio file failed	Provided audio file couldn’t be downloaded due to a timeout.
90041	User termination channels limit exceeded	The limit of simultaneous termination channels configured to your user has been reached.
90042	Outbound voice profile channels limit exceeded	The limit of simultaneous channels configured to the outbound voice profile associated to this connection has been reached.
90043	Connection outbound channels limit exceeded	The limit of simultaneous outbound channels configured to this call control connection has been reached.
90044	Conference join not allowed	Participant must not join the same conference twice.
90045	Media Streaming is used.	This command can’t be issued when media streaming is used.
90046	Media Streaming Failed.	The media streaming failed to start.
90048	Media Streaming is not used.	This command can only be issued when media streaming is used.
90049	Invalid value for record_timeout_secs	The ‘record_timeout_secs’ parameter must be an ‘integer’ with a minimum value of 0.
90053	Call recording triggered with ‘timeout_secs’ while transcribing	Call recording can not be started with ‘timeout_secs’ while the call is being transcribed.
90054	Call Transcription is already in progress	Call Transcription can not be started more than once.
90055	Call transcription can not be stopped	Call transcription can not be stopped while there is a recording with ‘timeout_secs’ in progress.
90056	Invalid value for initial_timeout_millis	The ‘initial_timeout_millis’ parameter must be an ‘integer’ with a minimum value of 1 and a maximum value of 120000.
90057	Invalid call control event type for webhook_urls	The webhook_urls json keys must be valid call control event types.
90058	Invalid conference_id	The conference does not exist.
90059	Invalid value for recording_track	The ‘recording_track’ parameter must be a ‘string’ with a value of either ‘inbound’, ‘outbound’ or ‘both’.
90080	Cannot issue a command on fax in the current state.	This command can only be issued when a fax is in either queued, media.processed or sending state.
90081	Cannot issue command for inbound fax.	This command can only be issued for outbound fax.
90100	Notification key is invalid	The notification key provided is invalid.
90101	Notification context is invalid	The required notification context was either invalid or not included in the request.
90102	Command is invalid	Call answer command cannot be issued for outbound calls.
100001	Invalid Dialogflow API	The value should be either ‘es’ or ‘cx’

⌘I