Skip to content

✉📲 SDK Library for Ruby to send SMS for FREE using MoceanAPI sms solution.


Notifications You must be signed in to change notification settings


Repository files navigation

MoceanAPI Client Library for Ruby

Gem Version build status Github build status codecov codacy MIT license total downloads

This is the Ruby client library for use Mocean's API. To use this, you'll need a Mocean account. Sign up for free at


To use the client library you'll need to have created a Mocean account.

To install the Ruby client library using Gem.

gem install moceansdk


Create a client with your API key and secret:

require 'moceansdk'

credential ="API_KEY_HERE", "API_SECRET_HERE")
mocean =


To use Mocean's SMS API to send an SMS message, call the mocean.sms.send() method.

The API can be called directly, using a simple array of parameters, the keys match the parameters of the API.

res = mocean.sms.send({
    "mocean-text": 'Hello World',
    "mocean-from": 'MOCEAN',
    "mocean-to": '60123456789'

puts res


For your convenient, the API response has been parsed to Hash using hash_dot package.

puts res           # show full response string
puts res.status    # show response status, '0' in this case
puts res['status'] # same as above


Kindly visit MoceanApi Docs for more usage


This library is released under the MIT License