Transactional SMS · Built for Kenya

Transactional SMS for Kenyan businesses

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.

from KES 0.45 at volume M-Pesa top-ups 0 contracts
POST /api/template/send sandbox
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" }
  }'
200 response
{
  "status": "success",
  "mobile": "254712345678",
  "transactionId": "6017967936947375520",
  "segments": 1,
  "characters": 54,
  "encoding": "gsm"
}
ACMEText message · now

Your Acme sign-in code is 482913. Valid for 5 minutes.

Delivered to handset · 1 segment

Example messages · Acme is a stand-in brand

Messages your customers expect to get

Sign-in codes

Your Acme sign-in code is 482913. Valid for 5 minutes.

code

Payment confirmations

Acme: We received KES 2,450.00 for invoice INV-1043. Thank you.

amount · invoice

Statements

Acme: Your September statement is ready. Balance due KES 12,800 by 15 Oct.

month · balance · due_date

Delivery updates

Acme: Order 5521 is out for delivery and will arrive today between 2pm and 5pm.

order · window

One template, filled in per send

How it works

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.

Approved

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

01

Write a template

Fixed text with named blanks for codes, amounts and names.

02

Get it reviewed

Within 24 hours. Use the sandbox while you wait.

03

Send with one call

Template slug, phone number and variables. The segment count comes back with the response.

04

Check delivery

See whether it reached the handset, with the operator's reason code when it didn't.

What you get

For account messages your customers act on

This is not a marketing blast tool. No promotional messages, ever. Recipients can block a sender at any time.

Approved templates

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.

Delivery reports

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.

Free sandbox

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.

M-Pesa top-ups

Pay by STK push and your credits appear immediately. No invoicing cycle, no contract, no minimum term.

A plain REST API

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.

Account visibility

See every sign-in to your account with browser, device and IP, and every failed attempt on your email.

For developers

Errors you can act on, retries that don't double-send

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.

200
AcceptedThe gateway took the message. Delivery status follows in your reports.
400
Bad requestMissing fields, unknown template, mismatched placeholders or a number that can't be parsed.
401
UnauthorizedThe API key is missing or invalid.
402
Top-up neededNot enough credits, or the account still needs its first top-up.
403
BlockedThe account is suspended, or the recipient has opted out of your sender.
429
Rate limited60 requests a minute on a live key, 300 in the sandbox.
502 504
Gateway errorSafe to retry. Use an Idempotency-Key so a retry never sends twice.
402 response
{
  "status": "failed",
  "code": "insufficient_credits",
  "message": "Insufficient credits"
}
Safe retries
-H "Idempotency-Key: 3f6c1a9e-…"

# Replays return the first result with
Idempotent-Replayed: true
Read the API docs

Pricing

One rate card. Nothing to pick.

Your rate follows your monthly volume and applies automatically from your top-up. Credits never expire.

12,000

Your rateKES 0.55/SMS

Estimated monthly costKES 6,600

Estimate assumes one segment per message. Long messages use more segments; the API tells you the count on every send.

Starter

0 – 3,000 messages a month Getting started
KES 0.65/SMS

BusinessYour band

3,001 – 50,000 messages a month Most accounts land here
KES 0.55/SMS

Enterprise

50,001+ messages a month Talk to us above this volume
KES 0.45/SMS

Every account gets

  • Templates reviewed within 24 hours
  • REST API with a free sandbox
  • M-Pesa top-ups, credits never expire
  • Email support

Registration is a first top-up of KES 10, returned in full as SMS credit.

Questions

Before you sign up

Can I send promotional messages?

No. GallantSMS is for transactional messages only: codes, confirmations, statements and updates. Every template is reviewed, and recipients can block a sender.

How long does template review take?

Within 24 hours. You can build and test against the sandbox while you wait.

What does it cost to start?

The sandbox is free. Going live takes a first M-Pesa top-up, which comes back in full as SMS credit.

Do credits expire?

No. Top up when you need to. There is no contract or minimum term.

What happens with long messages?

A long message is split into segments. Every send returns the segment and character count, so you always know what a message used.

Is there a rate limit?

60 requests a minute on a live key and 300 in the sandbox. Above that the API returns 429.

Contact

Get in touch

Questions about integration, volume pricing or a sender ID.

Phone
0750815413
Where we are
Nairobi, Kenya