Foauth Ruby client built on top of faraday.


To use this gem you'll need to go to and register for an account, then go to the services page and authenticate with the services you want to get your data out of.


Add this line to your application's Gemfile:

gem 'foauth'

And then execute:

$ bundle

Or install it yourself as:

$ gem install foauth


Create a new client passing in your foauth email and password.

client ='', 'secret')

When you make a request to one of the supported foauth services the url will automatically be converted to a foauth url using the hostname and the path.

response = client.get('')
# An authenticated request is made to

puts response.success?  # true
puts response.body      # [{"created_at":"Mon Dec 31 23:59:13 +0000 2012"...
puts response.status    # 200


The client returned is an instance of Faraday::Connection and the response is an instance of Faraday::Response.

You can pass a block to which will yield a Faraday::Builder instance. This allows you to customize middleware and change the default http adapter.

For example, if you want response.body to be automatically decoded for you then add faraday_middleware to your Gemfile and use the following code to add the json and xml parsing middleware.

require 'faraday_middleware'

client = '', 'secret' do |builder|
  builder.response :json, :content_type => /\bjson$/
  builder.response :xml, :content_type => /\bxml$/

See faraday for more information.


  1. Fork it
  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 new Pull Request

Version history

0.2.1 (January 5, 2013)

  • Make sure client works without blocks (#3)

0.2.0 (January 5, 2013)

  • Allow client to accept a block to configure Faraday (#2)

0.1.0 (January 5, 2013)

  • Make sure query string is passed through to foauth (#1)

0.0.1 (January 3, 2013)

  • Initial release


Thanks to @gulopine for creating

Inspired by requests-foauth by @kennethreitz.

Copyright (c) Chris Mytton