Skip to main content
POST
Create a verification

Authorizations

Authorization
string
header
required

Your API key from the Wave dashboard. Sandbox keys start sk_sandbox_; production keys start sk_live_. Send as Authorization: Bearer <key>. Some endpoints require a production key and specific scopes.

Headers

Idempotency-Key
string

Repeat-safe key; a retry returns the same verification without a second code minted or second message sent.

Body

application/json
phone_number
string
required

E.164 (+9665…) — the number Wave sends the code to.

channel
enum<string>
default:whatsapp
Available options:
whatsapp
locale
enum<string>
default:ar
Available options:
ar,
en
ttl_seconds
integer
default:300
Required range: 60 <= x <= 900
metadata
object

Response

Verification created; code sent

verification_id
string
state
string
Example:

"initiated"

expires_at
string<date-time>