Contact Importer for Ruby

Additionally to our simple widget integration,
CloudSponge offers an API for Ruby.

Get Started

Create your CloudSponge account and tell us your domain. If it’s your development environment you’ll get a CloudSponge Key for free.


JSON decoding package, currently supported are ActiveSupport::JSON and the JSON gem. Neither of these are required, but if you don’t have either on your system, a runtime error will be generated.


gem install cloudsponge


contacts = nil
importer =, DOMAIN_PASSWORD)
resp = importer.begin_import('YAHOO')
puts "Navigate to #{resp[:consent_url]} and complete the authentication process."
loop do
  events = importer.get_events
  break unless{ |e| e.is_error? }.empty?
  unless{ |e| e.is_complete? }.empty?
    contacts = importer.get_contacts

Other languages than Ruby

Don’t want to use Ruby? Not a problem! CloudSponge offers API for several languages:
PHPJavaRuby.NetColdFusion – or even a Do-It-Yourself Approach, which uses a REST API to return Contacts in JSON format.

Try CloudSponge for free in your
testing environment

Get Started

Have a questions or prefer a guided tour?
Schedule a consultation with our Founder.