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 Code	Message
account_limit_exceeded	This account has reached its limit. It must be upgraded to perform this action.
address_limit_exceeded	The number of allowed addresses has been exceeded.
already_assigned	This has already been assigned.
already_verified	This number is already verified.
alphanumeric_required	This value must be alphanumeric.
auto_top_up_deactivated	Auto top-up is not active on this account.
boolean_required	This value must be a true or false boolean.
brand_not_unique	The CSP Brand Reference must be unique within the space
campaign_inactive	Numbers cannot be assigned to an inactive campaign
campaign_limit_exceeded	The campaign limit has been exceeded.
campaign_not_found	The campaign ID provided could not be found.
cannot_cancel_in_progress	In progress calls can not be updated.
cannot_process	The request cannot be processed at the moment. Please try again later.
cannot_redirect_not_in_progress	Call is not in-progress. Cannot redirect.
cannot_remove_assignment_from_integration_test	You cannot remove the assignment from an integration test campaign.
cannot_update_completed	Completed calls cannot be updated.
conversation_flow_steps_are_invalid	This value must be an array. Example: ["Intro", ["Introduce yourself", "Ask caller's name"], "Summarize the conversation and thank the caller"]
datetime_required	This value must be a DateTime.
destination_number_not_supported	The destination phone number is not supported.
document_version_mismatch	The document_version does not match the current record's document_version.
does_not_exist	This entry does not exist.
duplicate_skill_type	Only one skill of this type can exist per AI Agent.
exceeds_history_logs_limit	This value exceeds the allowed date limit.
exceeds_platform_stream_limit	Adding an additional stream would exceed the allowed number of streams per room.
feature_not_available	This feature is not available to this account.
file_size_limit_exceeded	The file size is too big.
http_url_required	This value must be an HTTP or HTTPS URL.
incompatible_parameters	The parameters that were input cannot be specified together.
incorrect_keyword_format	Keywords must be comma separated values with no space.
incorrect_number_of_sub_use_cases	Mixed use case campaigns require minimum 2 and maximum 5 sub use cases.
insufficient_balance	This account has an insufficient balance.
invalid_addresses_for_transfer_skill	Addresses must contain non-empty values for name and destination
invalid_auth_token_permissions	Permissions list contains invalid selections. Valid permissions are calling, chat, fax, management, messaging, numbers, pubsub, storage, tasking, and video.
invalid_campaign_id	The campaign ID provided is invalid.
invalid_campaign_status	The campaign status is invalid.
invalid_chunking_params_for_page_chunking	Chunking parameters are not allowed for page chunking.
invalid_chunking_params_for_paragraph_chunking	Chunking parameters are not allowed for paragraph chunking.
invalid_chunking_params_for_sentence_chunking	Provided chunking parameters are not valid for sentence chunking. Allowed parameters are max_sentences_per_chunk and split_newlines.
invalid_chunking_params_for_sliding_chunking	Provided chunking parameters are not valid for sliding chunking. Allowed parameters are chunk_size and overlap_size.
invalid_destination_number	The destination phone number is invalid.
invalid_for_type	This is not valid for the current type.
invalid_http_method	This request method must be GET or POST.
invalid_list_items	The list items are invalid.
invalid_media_type	The media type provided is invalid.
invalid_media_url	The media URL provided is invalid.
invalid_message_body	The message body provided is invalid.
invalid_mustache_syntax	The mustache syntax is invalid..
invalid_number_format	The phone number is not in the correct format. Please use E.164 format, i.e., +15558675309.
invalid_object	This object is invalid. Refer to the error message for more details.
invalid_parameter	This list contains an invalid entry.
invalid_resource_type	The passed resource type is not a valid resource type
invalid_state	The object is not in the correct state for this action.
invalid_sub_use_cases	This sub use case is not valid.
invalid_subproject_id	The subproject ID passed could not be found or does not belong to the project being used to authenticate the request.
invalid_zendesk_capability	The Zendesk Capability is invalid.
json_or_yaml_required	Value must be a valid JSON or YAML document
list_of_hashes_required	This value must be an array of hashes
list_of_strings_required	This must be an array of strings only.
malformed_xml	The XML is not well formed
max_queued_messages_exceeded	has exceeded the maximum number of queued messages/calls for this number
media_size_exceeds_limit	The media size exceeds the allowed limit.
media_url_required	A media URL is required.
message_body_required	The message body is required.
message_length_exceeds_limit	The message length exceeds the allowed limit.
missing_fabric_application	Signalwire Access Token must be associated with a Fabric Application to perform this action
missing_required_parameter	A required parameter is missing from the request. Please refer to the technical reference for a complete list of parameters.
missing_sub_use_cases	Sub use cases are required for MIXED and LOW_VOLUME_MIXED campaigns.
must_belong_to_project	The requested resource must belong to the project being used to authenticate the request.
no_channel_specified	You must specify a channel.
no_devices_or_registrations	The fabric address has no registered devices or current online registrations.
no_installed_applications	Fabric Application must be installed in this project.
no_registered_devices	The fabric address has no registered devices.
not_a_valid_json	This value must be valid JSON.
not_available_for_assignment	This can not be assigned to the current target.
not_e164	The number must be in E.164 format.
not_purchased_or_verified	The phone number must be purchased or verified.
not_registered	The endpoint is not registered.
not_routable	The call is not routable.
not_valid_for_caller_id	The value is not valid (must be an E.164 number, caller ID string or SIP URI)
not_voice_capable	The number must be voice capable.
number_assignment_cannot_be_removed	Number assignments can only be removed if they are active, failed, or assigned to a pending campaign.
number_blacklisted	The phone number is blacklisted.
number_not_supported	The phone number is not supported.
number_not_verified	'From' phone number not verified.
number_of_assignments_exceed_limit	The requested assignment would exceed the allowed number of assigned numbers for the selected campaign.
page_token_required	A page token is required if the page_number value is greater than 0.
purchased_too_recently	This 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.
query_processing_failed	The query cannot be processed at the moment. Please try again later.
rate_limit_exceeded	The rate limit has been exceeded.
related_parameter_required	This parameter must be used in combination with its related parameter. See the reference for a complete list of available parameters.
resource_assigned_as_handler	You cannot delete a resource if it is currently assigned as a call or message handler
sort_order_validations	Sort order cannot be specified without sort by.
string_required	Value must be formatted as a string
sub_use_cases_present	Sub use cases are not permitted for non mixed campaign use case.
terms_and_conditions_required	You must agree to the terms and conditions to complete registration.
token_invalid_or_unadoptable	The provided FreeSWITCH token is incorrect or not ready for adoption
unique_within_project	Value must be unique within project
unsupported_mode	This mode is not supported on this number.
unsupported_region	This number must be from an allowed region.
upload_error	There was an error while uploading the file. Please try again.
value_not_unique	This value must be unique.