Verification codes
One-time codes that reach the phone while the person is still on the screen. Add an idempotency key and a retry never sends twice.
Read the APIBilled per segment.
Never on credit.
One-time codes that reach the phone while the person is still on the screen. Add an idempotency key and a retry never sends twice.
Read the APIPayment, delivery and account alerts, with the network’s receipt for each one: delivered, failed, expired or rejected.
SMS basicsReminders and updates to everyone who has not replied STOP. Opt-outs are handled for you.
See pricingThe API
POST the number and the text with an API token that can send SMS. Add an idempotency key and a retry never sends twice.
Send an SMS
$ curl https://api.bweze.com/v1/messages \ -H "Authorization: Bearer $BWEZE_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: order-1042" \ -d '{"to": "+250788123456", "body": "Your code is 482910"}' ✓ {"id": "…", "status": "sent", "segments": 1}
15 RWF a segment. GSM-7 fits 160 characters in one segment; an emoji switches the message to UCS-2, which fits 70.
A reply of STOP puts the number on your opt-out list and the API stops messaging it; START takes it off.
Every message keeps the receipts the network sends back, with the network’s reason when it fails.
Top up with mobile money. Each send holds its cost against your balance, so a message is refused, never sent on credit.
A message only counts when it arrives.
Per segment. A message in the GSM-7 alphabet fits 160 characters in one segment and 153 per segment when it is longer. A message with a character outside it, such as an emoji, uses UCS-2, which fits 70 characters in one segment and 67 per segment when longer. A send is refused before it costs anything if it would be over 10 segments.
Yes. Each message records the delivery receipts the network sends back, so you can see whether it was delivered, failed, expired or was rejected, and the network’s reason.
Their number joins your workspace’s opt-out list and the API refuses to message it with recipient_opted_out. Replying START takes it off the list. You can also add or remove a number yourself.
Yes. Send an idempotency key with the message; a retry with the same key returns the first result instead of sending again.
Top up your BWEZE wallet with mobile money. Each send holds its cost against your balance, so a message is refused rather than sent on credit when the balance is too low.