Sign-in codes
Your Acme sign-in code is 482913. Valid for 5 minutes.
code
Transactional SMS · Built for Kenya
OTPs, payment confirmations, statements and delivery updates. Sent over a REST API your developers can integrate in an afternoon.
Free sandbox. Test the whole request before you pay anything.
curl https://sms.gallantbyte.com/api/template/send \
-H "x-api-key: gs_test_••••••••••••" \
-H "Content-Type: application/json" \
-d '{
"templateSlug": "login_code_a1b2c3d",
"phoneNumber": "0712345678",
"variables": { "code": "482913" }
}'
{
"status": "success",
"mobile": "254712345678",
"transactionId": "6017967936947375520",
"segments": 1,
"characters": 54,
"encoding": "gsm"
}
Your Acme sign-in code is 482913. Valid for 5 minutes.
Delivered to handset · 1 segment
Example messages · Acme is a stand-in brand
Your Acme sign-in code is 482913. Valid for 5 minutes.
code
Acme: We received KES 2,450.00 for invoice INV-1043. Thank you.
amount · invoice
Acme: Your September statement is ready. Balance due KES 12,800 by 15 Oct.
month · balance · due_date
Acme: Order 5521 is out for delivery and will arrive today between 2pm and 5pm.
order · window
One template, filled in per send
You write the message once and we review it. After that, each API call only supplies the blanks. The content can't drift, so your sender ID stays compliant.
Template · login_code_a1b2c3d
Your Acme sign-in code is {{ code }}. Valid for 5 minutes.
Your API call sends
{
"templateSlug": "login_code_a1b2c3d",
"phoneNumber": "0712345678",
"variables": { "code": "482913" }
}
Customer receives
Your Acme sign-in code is 482913. Valid for 5 minutes.
54 characters · 1 segment · GSM
Fixed text with named blanks for codes, amounts and names.
Within 24 hours. Use the sandbox while you wait.
Template slug, phone number and variables. The segment count comes back with the response.
See whether it reached the handset, with the operator's reason code when it didn't.
What you get
This is not a marketing blast tool. No promotional messages, ever. Recipients can block a sender at any time.
Write a message once with named placeholders and have it reviewed. Then fill in the blanks per send. Your sender ID stays compliant because the content is fixed.
Know whether a message reached the handset, not just whether the gateway accepted it. You get the operator's own reason code when it did not.
A test key runs the whole request: validation, templates and errors. It stops before the gateway. Nothing sent, nothing charged, no payment needed to start.
Pay by STK push and your credits appear immediately. No invoicing cycle, no contract, no minimum term.
One endpoint, an API key in a header, JSON in and out. Segment counts come back with every send, so a long message is never a surprise.
See every sign-in to your account with browser, device and IP, and every failed attempt on your email.
For developers
Every failure comes back with a status code and a machine-readable reason. Add an Idempotency-Key header and a retried request won't send the message twice.
{
"status": "failed",
"code": "insufficient_credits",
"message": "Insufficient credits"
}
-H "Idempotency-Key: 3f6c1a9e-…"
# Replays return the first result with
Idempotent-Replayed: true
Pricing
Your rate follows your monthly volume and applies automatically from your top-up. Credits never expire.
Registration is a first top-up of KES 10, returned in full as SMS credit.
Questions
No. GallantSMS is for transactional messages only: codes, confirmations, statements and updates. Every template is reviewed, and recipients can block a sender.
Within 24 hours. You can build and test against the sandbox while you wait.
The sandbox is free. Going live takes a first M-Pesa top-up, which comes back in full as SMS credit.
No. Top up when you need to. There is no contract or minimum term.
A long message is split into segments. Every send returns the segment and character count, so you always know what a message used.
60 requests a minute on a live key and 300 in the sandbox. Above that the API returns 429.
Contact
Questions about integration, volume pricing or a sender ID.