Create an OTP

Create a one-time password. You choose how many characters it contains.

Last updated 13 September 2026

post

https://api.flutterwave.com/v3/otps

authorization string required

Pass your secret key as a bearer token in the request header to authorize this call

FILL IN ALL REQUIRED FIELDS

length int 32 required
The length of the OTP to generate. Expected value are between 5-7

customer object required
Customer-related information

FILL IN ALL REQUIRED FIELDS

name string required
The Customer's fullname. MaxLength: 10 characters.

email string required
The Customer's email address.

phone string required
The Customer's mobile number.

sender string required
The Sender name displayed in the OTP message.

send string required
Set to true to send otp to customer.

medium string required
The delivery method for the OTP. Supported values include sms, email and whatsapp.

expiry int 32
The expiry time, in minutes, of the OTP. Default value is 1 minute.

FILL IN ALL REQUIRED FIELDS

status string

message string

data array of objects

FILL IN ALL REQUIRED FIELDS

medium string

reference string

otp string

expiry string

FILL IN ALL REQUIRED FIELDS

status string

message string

data string

Shell