Created: 2008-07-27 12:59
Updated: 2016-05-08 11:13
License: mit


Build Status Code Climate

Ruby library for Kapow SMS gateway service


Include the gem in your Gemfile

  gem 'kapow'


To use this library you first need to sign up for an account at

The library wraps the HTTP POST service provided as this has the advantages of speed and an immediate response message.

# Create a new sms
msg ='username', 'password')
msg.deliver('mobile_no', 'sms')

All options supported by Kapow can be passed into the deliver method as a hash

# Send sms as a flash
msg.deliver('mobile_no', 'sms', :flash => true)

# Send sms with from_id (if enabled in account)
msg.deliver('mobile_no', 'sms', :from_id => 'from_id')

# Send sms up to 1377 characters long
msg.deliver('mobile_no', 'sms', :long_sms => true)

Responses provided by the Kapow SMS Gateway are:

Name Description
OK Message has been accepted for delivery.
USERPASS Invalid username or password.
NOCREDIT Account has no credits or credit limit has been reached.
ERROR Any other error has occurred.

The amount of remaining credit is included with the 'OK' response from the gateway. This is available as:

Kapow::Credit #=> 325
Cookies help us deliver our services. By using our services, you agree to our use of cookies Learn more