Skip to main content
POST
/
otps
Create an OTP
curl --request POST \
  --url https://api.flutterwave.com/v3/otps \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "length": 7,
  "customer": {
    "name": "Example User",
    "email": "user@gmail.com",
    "phone": "08130000000"
  },
  "sender": "Example Business",
  "send": true,
  "medium": [
    "email",
    "whatsapp"
  ],
  "expiry": 5
}
'
{
  "status": "success",
  "message": "OTP generated successfully",
  "data": [
    {
      "medium": "email",
      "reference": "CF-BARTER-20240318102713784653",
      "otp": "5880211",
      "expiry": "2024-03-18T10:32:14.1232277+00:00"
    },
    {
      "medium": "whatsapp",
      "reference": "CF-BARTER-20240318102714764558",
      "otp": "5880211",
      "expiry": "2024-03-18T10:32:14.7812808+00:00"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
length
integer<int32>
required
​
customer
Customer25 · object
required
Example:
{
  "name": "Example User",
  "email": "user@gmail.com",
  "phone": "08130000000"
}
​
sender
string
required
​
send
boolean
required
​
medium
string[]
required
​
expiry
integer<int32>
required

Response

OK

​
status
string
required
​
message
string
required
​
data
Data93 · object[]
required