Drip Ruby Bindings

A Ruby toolkit for the Drip API.

Installation

Add this line to your application's Gemfile:

gem 'drip-ruby'

And then execute:

$ bundle

Or install it yourself as:

$ gem install drip-ruby

Usage

To begin making requests, spin up a new Drip client:

client = Drip::Client.new do |c|
  c.api_key = "YOUR_API_TOKEN"
  c. = "YOUR_ACCOUNT_ID"
end

You can find your API key here and your account ID here.

Since the Drip client is a flat API client, most API actions are available as methods on the client object. The following methods are currently available:

Action Method
Create/update a subscriber #create_or_update_subscriber(email, options = {})
Fetch a subscriber #subscriber(id_or_email)
Subscribe to a campaign #subscribe(email, campaign_id, options = {})
Unsubscribe #unsubscribe(id_or_email, options = {})
Apply a tag #apply_tag(email, tag)
Remove a tag #remove_tag(email, tag)
Track an event #track_event(email, action, properties = {})

Note: We do not have complete API coverage yet. If we are missing an API method that you need to use in your application, please file an issue and/or open a pull request. See the official REST API docs for a complete API reference.

Examples

client = Drip::Client.new do |c|
  c.api_key = "YOUR_API_TOKEN"
  c. = "YOUR_ACCOUNT_ID"
end

# Fetch a subscriber
resp = client.subscriber("[email protected]")
# => <Drip::Response ...>

resp.success?
# => true

subscriber = resp.subscribers.first
subscriber.email
# => "[email protected]"

Contributing

  1. Fork it ( https://github.com/DripEmail/drip-ruby/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request