Skip to main content

Error Codes

When using SignalWire REST APIs, some errors will include error codes. Below, you will find a list of our unique error codes and a short explanation of each to help with error handling and troubleshooting.

Error CodeMessage
invalid_parameterThis list contains an invalid entry.
missing_required_parameterA required parameter is missing from the request. Please refer to the technical reference for a complete list of parameters.
value_not_uniqueThis value must be unique.
boolean_requiredThis value must be a true or false boolean.
datetime_requiredThis value must be a DateTime.
http_url_requiredThis value must be an HTTP or HTTPS URL.
list_of_strings_requiredThis must be an array of strings only.
alphanumeric_requiredThis value must be alphanumeric.
incompatible_parametersThe parameters that were input cannot be specified together.
related_parameter_requiredThis parameter must be used in combination with its related parameter. See the reference for a complete list of available parameters.
not_available_for_assignmentThis can not be assigned to the current target.
already_assignedThis has already been assigned.
invalid_for_typeThis is not valid for the current type.
feature_not_availableThis feature is not available to this account.
insufficient_balanceThis account has an insufficient balance.
account_limit_exceededThis account has reached its limit. It must be upgraded to perform this action.
rate_limit_exceededThe rate limit has been exceeded.
invalid_number_formatThe phone number is not in the correct format. Please use E.164 format, i.e., +15558675309.
number_not_supportedThe phone number is not supported.
number_not_verified'From' phone number not verified.
number_blacklistedThe phone number is blacklisted.
invalid_media_urlThe media URL provided is invalid.
media_url_requiredA media URL is required.
invalid_media_typeThe media type provided is invalid.
media_size_exceeds_limitThe media size exceeds the allowed limit.
message_body_requiredThe message body is required.
invalid_message_bodyThe message body provided is invalid.
message_length_exceeds_limitThe message length exceeds the allowed limit.
invalid_destination_numberThe destination phone number is invalid.
destination_number_not_supportedThe destination phone number is not supported.
invalid_campaign_idThe campaign ID provided is invalid.
invalid_campaign_statusThe campaign status is invalid.
campaign_limit_exceededThe campaign limit has been exceeded.
campaign_not_foundThe campaign ID provided could not be found.
invalid_auth_token_permissionsPermissions list contains invalid selections. Valid permissions are calling, chat, fax, management, messaging, numbers, pubsub, storage, tasking, and video.
invalid_subproject_idThe subproject ID passed could not be found or does not belong to the project being used to authenticate the request.
already_verifiedThis number is already verified.
unsupported_regionThis number must be from an allowed region.
purchased_too_recentlyThis number was purchased too recently to release. Please wait 14 days after purchase to release this number or 30 days if your account is in trial mode. Contact Support for further assistance.
does_not_existThis entry does not exist.
unsupported_modeThis mode is not supported on this number.
invalid_stateThe object is not in the correct state for this action.
not_a_valid_jsonThis value must be valid JSON.
upload_errorThere was an error while uploading the file. Please try again.
file_size_limit_exceededThe file size is too big.
no_channel_specifiedYou must specify a channel.
cannot_remove_assignment_from_integration_testYou cannot remove the assignment from an integration test campaign.
auto_top_up_deactivatedAuto top-up is not active on this account.
invalid_objectThis object is invalid. Refer to the error message for more details.
exceeds_platform_stream_limitAdding an additional stream would exceed the allowed number of streams per room.
invalid_auth_token_permissionsPermissions list contains invalid selections. Valid permissions are calling, chat, fax, management, messaging, numbers, pubsub, storage, tasking, and video.
invalid_subproject_idThe subproject ID passed could not be found or does not belong to the project being used to authenticate the request.