Errors

Prelude uses conventional HTTP statuses to indicate the success or failure of a request:

Codes in the 2xx range indicate success.
Codes in the 4xx range indicate an error that failed given the information provided (e.g. required parameter was omitted or an authentication failed).
Codes in the 5xx range indicate an error with Prelude’s servers (these are rare).

Codes

Below is a list of possible error codes, along with additional information about how to resolve them.

Code	Description
`invalid_phone_number`	This is not a valid E.164 number.
`internal_server_error`	An internal server error occurred.
`bad_request`	The request was malformed.
`account_invalid`	The provided customer UUID is invalid.
`negative_balance`	You have a negative balance.
`invalid_line`	Prelude does not support this type of phone number.
`unsupported_region`	Prelude does not support this region yet.
`invalid_auth_uuid`	The provided authentication UUID is invalid.
`blocked_number`	The phone number is in the blocklist.
`invalid_app_version`	The provided application version is invalid.
`invalid_os_version`	The provided OS version is invalid.
`invalid_device_model`	The provided device model is invalid.
`invalid_device_id`	The provided device ID is invalid.
`no_associated_auth_found`	The associated authentication was not found.
`duplicated_feedback_status`	Duplicated feedback status has found.
`invalid_feedback_status`	The provided feedback status is invalid.
`invalid_template_id`	The provided template ID is invalid.
`suspended_account`	Your account has been suspended.

code

enum<string>

A machine-readable code that describes the error.

Available options:

invalid_phone_number,

internal_server_error,

bad_request,

account_invalid,

negative_balance,

invalid_line,

unsupported_region,

invalid_auth_uuid,

invalid_app_realm,

unsupported_app_realm_device_type,

app_realm_require_device_type,

blocked_number,

invalid_app_version,

invalid_os_version,

invalid_device_model,

invalid_device_id,

no_associated_auth_found,

duplicated_feedback_status,

invalid_feedback_status,

invalid_template_id,

suspended_account

message

string

A human-readable message that describes the error.

doc_url

string

A link to the documentation that describes the error.