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.

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