Codes

This page presents how to handle errors with our Legacy API, V1.

Errors

Troubleshooting errors (V1 API)

Prelude Documentation

Explore our guides and examples to implement Prelude, our powerful and easy-to-use API that lets you send OTP codes and transactional messages worldwide.

Overview

Understand how Prelude works to leverage its full potential.

How Prelude works

Learn how Prelude partners with multiple providers and channels to guarantee the highest possible delivery rate at the lowest possible cost.

Multi-Routing

Multi-Routing explained

Understand how Prelude's fraud prevention algorithm works, the type of fraud it prevents and how to configure it.

Anti-Fraud

Anti-Fraud explained

Monitor your performance and configure your integration with your Dashboard. To get access to the dashboard, you must first sign up and create an app.

Dashboard

The Prelude Dashboard

Learn how to use our iOS SDK. It allows you to capture certain device signals that will be reported back to Prelude.

iOS SDK

Learn how to use our Android SDK. It allows you to capture certain device signals that will be reported back to Prelude.

Android

Android SDK

Learn how to use our Expo React Native SDK. It allows you to capture certain device signals (both in Android and iOS) that will be reported back to Prelude.

React Native

React Native SDK

Learn how to capture front end browser signals to integrate them with the verification backend APIs. It allows you to capture certain browser signals that will be reported back to your Prelude account.

JS Signals

JavaScript Signals SDK

Node.js

Python

Kotlin/Java

GitHub

Manage the full lifecycle of your users' sessions.

Introduction

Prelude Session API

Learn how Prelude session applications work.

Applications

Session Applications

Learn about the cookies used by the Session API.

Cookies

Learn about the JWKS used by the Session API.

JWKS

JSON Web Key Set (JWKS)

Send and verify a code in 2 minutes and 3 simple steps with our SDKs, available for Node.js, Python, and Go.

Quickstart

Analytics

Analytics explained

Learn how to confirm that your integration is working properly by simulating OTPs without incurring charges using special test numbers.

Testing

Send OTPs to test your integration

Configure your integration to protect your application against fraud like SMS pumping or IRSF fraud with Prelude’s machine learning models.

Prevent Fraud

Learn how to integrate the Prelude APIs and SDKs with other platforms.

Integrations

Everything you need to integrate the V2 API from any language and access our Verify, Transactional and Watch APIs and features.

Introduction to the V2 API

Everything you need to know about Prelude Transactional API to start sending transactional messages to your users via SMS and online messaging channels.

Introduction to the Transactional API

Prelude Transactional API can notify your application about events using webhooks. Get notified when your messages are delivered and billed.

Webhook

Webhook for the Transactional API

Integrate the Prelude Verify API from any language to start sending OTP messages to your users worldwide using multiple messaging channels.

Send OTP codes worldwide using the Verify API

Prelude Verify API can adapt your verification messages content for specific use cases.

Templates

Using Templates

Prelude Verify API can notify your application about events using webhooks. Get notified when your messages are delivered and billed.

Webhook for the Verify API

Identify trustworthy email addresses or phone numbers to mitigate both fake and fraudulent traffic.

Introduction to the Watch API

Learn how to troubleshoot errors like invalid custom code or unauthorized Sender ID to ensure a robust integration.

Troubleshooting errors

Introduction to the V1 API (Legacy)

This page presents how to send a code with our Legacy API, V1.

Send a code

Send a code (V1 API)

This page presents how to check a code with our Legacy API, V1.

Check a code

Check a code (V1 API)

This page presents how to perform a retry with our Legacy API, V1.

Perform a retry

Perform a retry (V1 API)

Send feedback

This page presents how to get authentication status with our Legacy API, V1.

Get authentication status

Get authentication status (V1 API)

Look up for phone number

Ruby

Java

Learn how to easily register a webhook with Prelude to get notified when your messages are delivered and billed.

Code	Description
`account_invalid`	The provided customer UUID is invalid.
`bad_request`	The request was malformed.
`blocked_number`	The phone number is in the blocklist.
`duplicated_feedback_status`	Duplicated feedback status has found.
`internal_server_error`	An internal server error occurred.
`invalid_app_version`	The provided application version is invalid.
`invalid_auth_uuid`	The provided authentication UUID is invalid.
`invalid_device_id`	The provided device ID is invalid.
`invalid_device_model`	The provided device model is invalid.
`invalid_feedback_status`	The provided feedback status is invalid.
`invalid_line`	Prelude does not support this type of phone number.
`invalid_os_version`	The provided OS version is invalid.
`invalid_phone_number`	This is not a valid E.164 number.
`invalid_sender_id`	The provided Sender ID is invalid.
`invalid_template_id`	The provided template ID is invalid.
`negative_balance`	You have a negative balance.
`no_associated_auth_found`	The associated authentication was not found.
`suspended_account`	Your account has been suspended.
`unauthorized_sender_id`	The provided sender ID is not authorized to send messages.
`unsupported_region`	Prelude does not support this region yet.
`spending_limit_exceeded`	The spending limit for a time period has been exceeded. You can set the spending limits from your Dashboard.

Documentation

API Reference

SDKs

​Codes

Codes